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Background 

Field of the Invention 

[0003] This invention relates to information systems and, more particularly, to a system 

and method for automating the creation of electronic documents. 

Background of the Invention 
[0004] Many individuals and organizations create and maintain documents that contain 

information. The individual documents can be organized in such a way as to form a coherent set 

of documents that provide information about the individual or company, or other useful 

information. One example of such a document is a web page, and one example of the coherent 

set of documents is a web site. The web sites include large numbers of web pages, which are 

linked together, so that people can easily access and move back and forth between the web pages. 

These web sites are created and periodically changed, modified, or updated. It is desirable to 
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provide an Internet-based web publishing system and method that simplifies the creation and 
editing of web sites. 

[0005] It can take a high level of technical skill to create and organize a web site and the 
pages on that web site. In contrast, adding content can be a simple operation. However, if users 
of little skill access the web site to add content, they may make a mistake that adversely affects 
the operation of the web site. Thus, it is desirable to allow technically skilled users to create and 
organize a web site, and give them the ability to allow less skilled users to enter content without 
the possibility of the less skilled users creating problems with the web site. 
[0006] Typically, when a new web page is created, links to that web page must be manually 
added to the pages from which the new web page will be linked. Every time a web page is 
added, and often when a web page is changed, the page that links to that page must be changed. 
This can be a time consuming and challenging task. It is easy to lose track of which documents 
should link to the created or modified document, so it is easy to fail to update the links correctly. 
Similarly, some web pages have links to other locations on the same page. When the web page is 
changed the links must also be changed. Again, this task can be time consuming and difficult to 
do correctly. Users of limited skill would typically be unable to perform this task. Thus, it is 
also desirable to provide a way to more easily add and update links to documents such as web 
pages. 

[0007] Further, in such a web publishing system, the locations of some web pages can 
change in relation to one another as pages are created, edited, previewed, published, and 
maintained. For example, a web page may be in one location during editing, then moved to 
another location for normal use and viewing of that web page. System maintenance may require 
that web pages be moved from server to server. Certain uniform resource locators ("URL"s) 
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within the web pages do not function correctly if the location of the web pages containing the 
URL changes. Therefore, it is also desirable to provide a way to automatically modify URLs so 
that the URLs of web pages work correctly in a web publishing or similar system. 

Summary of the Invention 
[0008] One embodiment of the present invention automatically generates, in a first 

document, a link or links to another document or documents. The first document includes a 

specification for what documents the first document should link to, and how the links should be 

presented. When the first document is created or edited, the available documents are searched 

for documents that meet the specification. Links to documents that meet the specification are 

generated and added to the first document. Alternatively, specified information, such as the 

titles, from the other documents is added to the first document instead of, or in addition to, the 

links. 

[0009] Another embodiment of the present invention automatically generates within a 
document an index to the information within that document. A user adds pieces of data to the 
document. For each piece of data, an index entry is generated. The index entry may include a 
link to the location in the document of the data piece. 

Brief Description of the Drawings 
[0010] Figure 1(a) is a block diagram of a web publishing system that automatically 

rewrites URLs. 

[0011] Figure 1(b) is a block diagram showing more detail of the edit server and the editing 
client. 

[0012] Figure 2 is a flow chart showing how the user creates, edits and maintains the web 
site. 
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[0013] Figure 3(a) is a block diagram of how the templates and web pages are stored on the 
edit server. 

[0014] Figure 3(b) is a block diagram of how the web pages are stored on the user server. 

[0015] Figure 4(a) is a screenshot showing the step of defining a template in more detail. 

[0016] Figure 4(b) is a screenshot showing a template preview. 

[0017] Figure 4(c) is a screenshot of a template link test. 

[0018] Figure 4(d) is a screenshot showing how to perform the step of making pages in 
more detail. 

[0019] Figure 4(e) is a screenshot showing how a user enters content into a page. 

[0020] Figure 4(f) is a screenshot showing a page preview. 

[0021] Figure 4(g) is a screenshot showing how to create or edit a page using the task UI. 

[0022] Figure 4(h) is a screenshot showing a page preview using the task UI. 

[0023] Figure 5 is a flow chart the URL modification process. 

[0024] Figures 6(a) through 6(c) are a chart showing when the URLs are rewritten. 

[0025] Figure 7 is a chart showing when URLs are retargeted. 

[0026] Figure 8 is a block diagram showing a simplified overview of an embodiment of a 
file organizational structure. 

[0027] Figure 9 is a block diagram showing an example of how links to other documents is 

automatically generated in a document. 

[0028] Figure 1 0 is a diagram of an index document. 



Detailed Description of the Preferred Embodiments 
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Introduction : 

[0029] Documents, such as web pages on the Internet, are created and modified more easily 
by use of a document creation and editing system. The web pages are created by combining a 
template file and a content file. A user creates a template file that provides common elements to 
web pages based on that template. Thus, the template will typically provide a general "look and 
feel" for web pages based on that template. The template also includes definitions for what type 
of information will be added to create the web pages based on that template. The same or 
different user then creates web pages based on that template by entering content to be used with 
the template. The web page is then created by combining the template with the content. 
[0030] In some embodiments, there are multiple levels of users. Higher level users may 
access all features of the document creation and editing system. These higher level users may 
create templates, organize the web site, and define what features lower level users have access to. 
Lower level users have access to fewer than all the features of the system. For example, a lower 
level user may have the ability to form web pages by entering content related to a single template, 
or a discrete set of templates. With the template, the higher level users have defined what sort of 
content the lower level user may enter, and how that content will appear in the web page. The 
higher level users may prevent the lower level users from making mistakes that adversely affect 
the operation of the web site and web pages by limiting the access of the lower level users to 
certain, narrowly defined functions. 

[0031] The system also makes it easy to link documents, such as web pages, together. The 
system allows users to define what sort of links will be created. These links can be links within 
one document to other, separate, documents. The links can also be links to locations within the 
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same document. The system then automatically creates and updates the links as documents are 
created and modified. 

[0032] Further, documents, such as web pages on the Internet, contain indirect addresses, 
such as URLs, that refer to other documents and files. It is often useful to modify these 
addresses. For example, some of these addresses indicate a location relative to other locations. 
With some such addresses, if the web page moves, the address may not function correctly. Some 
embodiments of the present invention modify indirect addresses in documents, such as URLs in 
web pages, as the location of the document changes or under other circumstances so that the 
indirect addresses continue to function correctly. In the described embodiment, the indirect 
addresses are URLs, the documents are web pages on the Internet. However, the invention is not 
limited to such an application, and also applies to other types of documents with other indirect 
addresses and on other networks. 

Definitions : 

[0033] Definitions of various selected terms are listed below. 

[0034] Template : A document that defines the design elements of a web page. Typically, 
the template will define a general "look and feel" for web pages based on that template. The 
template may also define other elements, such as keywords, or a brief description of the page. 
The template includes defined sections for adding content. Generally, the document is written in 
hypertext markup language ("HTML"), or an extended HTML. 

[0035] Content : Data that provides information for a particular instance of a template. 
Content is combined with a template to form a web page. Typically, multiple content files exist 
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related to the same template, such that each content file is combined with the template to form a 
separate web page based on that template. 

[0036] Web Page : For clarity, the description describes the invention in the context of web 
pages. However, the invention is not limited to web pages, but also includes other document 
forms. Thus, the term "web page" as used herein does not only refer to web pages, such as those 
known to be used on the World Wide Web on the Internet, but refers to other document types as 
well. 

[0037] Publish : Combining the template with content files to create the web pages, and 
placing the web pages on the user server for normal use. 

[0038] Stage : Combining the template with content files to create the web pages, and 
placing the web pages on the staging server to allow review of the web pages before sending 
them to the user server. 

[0039] Template preview : In a template preview, the user sees the template as it would 
look as part of a web page. 

[0040] Page preview : In a page preview, the user sees a web page as it would look on the 

staging server or user server. A template and content are combined in a page preview. 

[0041] Site base : The root of the client's web site, which will contain the web pages if the 

web pages are published externally. Example: http://www.client.com. 

[0042] Internal web page : A web page managed by the web publishing system. The 

internal web pages are created or edited by the web publishing system. 

[0043] External web page : A web page not managed by the web publishing system. While 
the web publishing system does not create or edit external web pages, external web pages may be 
referenced by URLs of internal web pages. 
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[0044] URL : Stands for "Uniform Resource Locator/' The URL defines the location of a 
file. The URL is a type of indirect address, and refers to the direct, address. While the term URL 
is commonly used in the description below, other types of indirect addresses may also be used. 
[0045] Absolute URL : A URL that includes the complete scheme and server. Example: 
http://www.atomz.com/images/logo.gif. An absolute URL is not relative to the location of the 
document that contains the URL. 

[0046] Site relative URL : A URL that specifies a location relative to the current server. 
Example: /images/logo.gif. 

[0047] Document relative URL : A URL that specifies a location relative to the document 
in which the URL appears. Often, but not always, document relative URLs start with two dots 
and a slash ("../")• Example: ../logo.gif. 

[0048] Template relative URL : A URL within a template file that specifies a location 
relative to the template file in the web publishing system. A template relative URL is a type of 
document relative URL. 

[0049] Page relative URL : A URL that specifies a location relative to a merged page in the 
web publishing system. A page relative URL is a type of document relative URL, and is 
identified as a page relative URL by a marking code. 

[0050] System relative URL : A URL that specifies a location relative to the site base that 
will contain the web page. A system relative URL is a type of document relative URL, and is 
identified as a system relative URL by a marking code. 

[0051] Same page link URL : A URL that specifies a location on the same web page that 
contains the same page link URL. 
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[0052] Local publish/local stage : A publish or stage, where the user server or staging 

server is part of the edit server, instead of a separate physical server. Certain URLs usually are 

modified when the templates and content files are combined for staging or publishing. 

[0053] External publish/external stage : A publish or stage, where the user server or staging 

server is a separate server, instead of part of the edit server. Certain URLs usually are modified 

when the templates and content files are combined for staging or publishing. 

[0054] Internal URL : A URL that references a file that is one of the files managed by the 

web publishing system. 

[0055] External URL : A URL that references a file that is not one of the files managed by 
the web publishing system. 

[0056] Link: A link can be a hyperlink, as commonly used in web pages, or another type of 
pointer or reference to a document or location within a document. 

Web Publishing System : 
[0057] Figure 1(a) is a block diagram of a web publishing system 100 that allows a user to 

easily create and edit web pages that make up all or part of a web site. As the web pages move 

from one location to another, the web publishing system 100 automatically modifies URLs to 

function correctly. The system 100 includes an edit server 102. The edit server 102 stores web 

page template data, content data, and software and/or hardware instructions used to edit the web 

site. The edit server 102 also provides a user interface to an editing client 104 to allow the user 

to create and maintain the web site. The edit server 102 can be one server computer unit, or 

distributed over multiple computers. 
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[0058] The edit server 102 is connected to the editing client 104 via a network such as the 
Internet 106. When a user wishes to edit the web site, the user uses an editing client 104, in 
some embodiments a personal computer with a web browser, to access the edit server 102. The 
edit server 102 provides functionality to allow a user on an editing client 104 to access editing 
tools and a current, edited copy of the template and content files that comprise the web site. In 
some embodiments, the edit server 102 does this by sending information to the editing client 104 
that is interpreted and displayed on the web browser of the editing client 104 and receiving user 
instructions from the editing client 104. 

[0059] The edit server 102 stores the edited, updated version of the web site. However, 
this edited version is not available for general viewing until the changes are sent to the user 
server 110 where the actual web site resides for general use. The user server 110 can be a 
separate physical server, or can be a part of the edit server 102. The user server 1 10 can also be 
one server unit, or distributed over multiple computers. 

[0060] Additionally, in some embodiments, the web publishing system 100 includes a 
staging server 108. The staging server 108 allows the user to preview the web site after editing 
and before the web site is sent to the user server 1 10 for general use. The staging server 108 can 
be a separate physical server, part of the user server 1 10, or part of the edit server 102. The 
staging server 108 can also be one server unit, or distributed over multiple computers. Staging is 
an optional step between editing the web site and publishing the web site. 
[0061] The user server 1 10 is connected to the edit server 102. In one embodiment, the 
user server 1 10 is connected to the edit server 102 via the Internet 106. However, the user server 
1 10 may be connected to the edit server 1 02 by other systems and methods. For example, other 
networks besides the Internet could also be used. The edit server 102, or alternatively the staging 
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server 108, sends the web pages to the user server 1 10. The edit server 102 can send a single 
page, multiple pages, all pages that have been updated, or the whole web site to the user server 
1 10 so that the user server 110 contains the most recent edition of the web site. 
[0062] From the user server 1 1 0, the site is available to those who wish to view the pages. 
A plurality of viewing clients 1 12 may be connected to the user server 1 10 via the Internet 106. 
Viewing clients 1 12 view the web pages stored on the user server 1 10 via the Internet 106. 
[0063] Figure 1 (b) is a block diagram showing more detail of the edit server 1 02 and the 
editing client 104. The edit server 102 includes a web page module 1 14, a publish module 1 16, a 
template module 118, a content module 120, a file structure manager module 1 15, and a user 
interface module 122. The user interface module 122 includes a template update module 126, a 
content update module 128, a preview module 130, an initiate publish module 132, and a 
communication module 134. The content module 120 includes a database module 140, which is 
connected to a database 142. The template module 118 also includes a database module 136, 
which is connected to a database 138. While the databases 138 and 142 are shown as being 
within the edit server 102, the databases 138 and 142 may also be located elsewhere. All 
templates and content files may also be stored in a single large database, rather than multiple 
databases. The editing client 104 includes a client interface module 124. The modules can be 
implemented in software, hardware, or firmware. 

[0064] The user interface module 122 provides a user interface to the user via the client 
interface module 124 on the editing client 104. In some embodiments, the client interface 
module 124 is a web browser. The user interface module 122 passes data to the client interface 
module 124 and receives data from the client interface module 124. This data can take many 
forms, including HTML and other types of data. In embodiments, such as described herein, 



Case 21540-05799 



11 



where the client interface module 124 is a web browser, the data will typically be in HTML 
format. The communication module 134 of the user interface module 122 sends HTML data to 
the client interface module 124. The HTML data is interpreted and displayed by the client 
interface module 124 to provide a user interface for the user. This user interface provides 
information to the user and allows the user to enter and send infoimation to the edit server 102. 
[0065] The user enters information defining or editing templates into the client interface 
module 124 of the editing client 104. The client interface module 124 displays a field into which 
the user may enter HTML code that defines the template. After the user enters the code, the 
client interface module 124 sends the code to the communication module 134 via the Internet 
106. The communication module 134 directs the code to the template update module 126, which 
in turn sends the code to the template module 118. The template module 118 manages the 
templates in the database 138. If the template is a new template, the template module 118 stores 
the code in a database 138, via a database module 1 36. If the template is an edited version of a 
template that already exists, the template module 118 updates the template stored in the database 
138, via the database module 136. 

[0066] The user also enters information defining web page content into the client interface 
module 124. The client interface module 124 displays a field into which the user enters the 
content. After the user enters the content, the client interface module 124 sends the code to the 
communication module 134 via the Internet 106. The communication module 134 directs the 
code to the content update module 128, which in turn sends the code to the content module 120. 
The content module 120 manages the content files in the database 142 via the database module 
140. If the received content is an edited update of existing content, the content module 120 
updates the existing content in the database 142. 
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[0067] When the user creates template files or content files, the files are stored in an 
organizational structure. The file structure manager module 115 keeps track of the organization 
of the files, and also keeps track of when files are added, deleted or edited. Organizational 
structures can take the form of a folder and file system as is well known in the art and used with 
both Microsoft Window and Apple Macintosh operating systems. The user defines the location 
of each template file, content file, and web page that results from the merging of a template file 
and content file. Content files can be treated as web pages for organizational purposes, since it is 
known which template the content files will be merged with to form the web pages. Thus, the 
content files can be treated as having the same location within the organizational structure as the 
web pages that will result from the merging of the template with that content file. When the user 
creates or edits a content file or template file, or merges a template file and content file to create a 
web page, the template module 118, content module 120, or web page module 114 notifies the 
file structure manager module 115 of the change. In some situations, when a file is changed, 
other files should be automatically changed as well. By keeping track of which files are changed, 
the file structure manager module 115 can notify the template module 118, content module 120 
or web page module 1 14 to change the template file, content file, or web page as needed. The 
template module 1 18 or content module 120 can then automatically change the template file or 
content file in one of the databases 138 and 142, then the web page module 114 can 
automatically merge the changed template file and/or content file to create the updated web page. 
[0068] When the user desires to view a web page while using the editing client 104, the 
user sends a request to the user interface module 122 via the client interface module 124 and the 
Internet 106. The user interface module 122 receives the request at the communication module 
134, which sends the request to the preview module 130. The preview module 130 then sends a 
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request to the web page module 1 14. The web page module 1 14 is a type of document module 
that handles web page documents. In other embodiments with other document types, the web 
page module 1 14 may be replaced with a document module specific to the type of document 
used. The web page module 1 14 retrieves the web page from cache or generates the web page by 
combining a template from the template module 1 1 8 and content from the content module 120 
and delivers the web page to the preview module 130, which sends the web page to the 
communication module 134, which in turn passes the web page to the client interface module 
124 for the user to view. 

[0069] When the user desires to view the current version of the web site on either the 
staging server 108 or the user server 110, the user sends a request to the user interface module 
122 via the client interface module 124 and the Internet 106. The user interface module 122 
receives the request at the communication module 134, which sends the request to the initiate 
publish module 132. The initiate publish module 132 then sends the request to the web page 
module 1 14. The web page module 1 14 delivers the web page to the publish module 116, which 
in turn passes the web page to either the staging server 108 or the user server 1 10, depending on 
the user's request. 

[0070] To deliver a web page to the preview module 130 or the publish module 1 16, the 
web page module 1 14 combines a template from the template module 1 18 and content from the 
content module 120. Alternatively, the template and content are retrieved from cache. When a 
template and content are merged to form a web page, that web page is cached. If neither the 
template nor the content has been changed since the last time the template and content were 
merged to form the web page, the merged web page is retrieved from cache instead of combined 
again. When a new or edited template or content file is sent to the template module 118 or 
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content module 120, the template module 1 18 or content module 120 notifies the web page 
module 1 14 so that the web page module 1 14 is able to track whether the web page may be 
retrieved from cache, or should be created from combining template and content. 
[0071] Typically, the template and content each contain URLs. The web page that the web 
page module 114 forms from the combination of the template and content also contains URLs. 
The web page may be at a different location than the template and content. In order for the URLs 
in the web page to function correctly, the web page module 1 14 modifies the URLs in the web 
page. The manner in which URLs are modified depends on whether the web page will be sent to 
the client interface module 124, the user server 1 10, or the staging server 108. After combining 
the template and content, the web page module 1 14 sends the web page with modified URLs to 
the publish module 1 16, to be sent to the user server 1 10 or the staging server 108, or to the 
preview module 130, to be sent to the client interface module 124. 

Web Page Creation And Editing Overview : 
[0072] Figure 2 is a flow chart 200 showing a summary overview of how the user creates, 

edits and maintains the web site. The user first creates 202 a template. The template is a file that 

defines a general look and feel for web pages based off that template. This simplifies the 

creation of web sites comprised of multiple web pages with a same general look and feel. The 

user interface module 122 provides an interface to the client interface module 124 to allow the 

user to create the template. After creation of the template, one or more web pages will be created 

from that template. 

[0073] In some embodiments, there are different user levels. Higher level users have 
access to more of the system functions than lower level users. For example, higher level users 
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create the templates, while lower level users do not have the ability to create templates. Higher 
level users also may organize the files of the web site, and define what functions a lower level 
user may use. 

[0074] The template defines aspects that will appear in every web page based on that 
template. Typically, the template will define a general "look and feel" for web pages based on 
that template. However, web pages based on the template also have aspects that differ from web 
page to web page. The content provides the aspects of a web page that are different from the 
other web pages based on the template. When creating the template, the user defines what 
aspects will differ in web pages based on the template. The user defines where content can be 
inserted, and what kind of content can be inserted in web pages based on the template. The use 
of templates makes it easy to ensure a uniform look and feel across a web site because the 
template defines much of each page based on it. 

[0075] In some embodiments, the user creates the template using HTML code. Special tags 
define such things as what items are editable when creating pages based on the template and what 
items remain constant for all pages based on the template. There are also special marking codes 
for certain URL types. Some of the special tags used (in addition to standard HTML) to create 
the template in one embodiment are found in Appendix I. The special tags are intermixed with 
industry standard HTML in the template. The combination of special tags and HTML coding 
defines the visual characteristics of the template and the associated content. The user can hand- 
code the HTML, or can use one of any number of commercial products that allow a user to easily 
define the look of a page and automatically generate the actual markup language code. The user 
may have to add the special tags to the code generated by the commercial product, if the 
commercial product only generates standard HTML code. Alternatively, the commercial 
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products themselves may include functionality to add the special tags automatically. In one 
embodiment, if a commercial product generates the HTML code, the user then cuts and pastes 
the code into the template. Alternatively, the commercial product interfaces with the template 
module 118 and directly stores the generated code in the template file. After the user creates the 
template, the template is stored in the template module 118. The user may preview the template 
while editing to check that the user has coded the template correctly. 

[0076] After the template has been created, the user adds 204 content to create web pages 
based on that template. Typically, lower level users are restricted to doing this. During the 
creation of the template, the higher level user utilized special tags to define editable sections of 
the template. These editable sections of the template define the locations and types of content 
that may be entered. When creating the web pages, the editable sections of the template are 
marked. The user then enters content for insertion into the editable sections. Thus, the lower 
level user may only enter content that has a limited effect on the final web page and web site. 
[0077] Little to no knowledge of HTML is needed when entering content. Thus, users with 
little technical skill can be designated as lower level users, where they may enter content to create 
web pages, with little fear their limited skills would lead them to make a mistake and cause 
problems with the web pages or web site. Since the higher level users define what the lower 
level users are able to do, the more skilled higher level users may retain control over most of the 
web site and web pages, while allowing less skilled lower level users to do some of the work of 
creating and modifying web pages. The user interface provided to the editing client 1 04 when 
creating web pages shows the template with symbols marking sections that the user can edit. The 
user selects a symbol and is presented with an area in which to enter the content along with 
prompts as to what content to enter. The user enters in the text or otherwise defines information 
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that the user desires to be included as content in that page. The information can include pictures, 
audio files, video files, or other information. The content entered is stored in a content file 
associated with the template. By selecting the edit symbols and entering the information, the 
user adds the content that differentiates a particular web page from other web pages based on the 
template. 

[0078] The user can use the same template and enter different sets of content to create 
several different web pages based on that template. On the edit server 102, the content, which 
includes the information the user has entered that is relevant to a single web page, is stored 
separately from the template as a content file. This content file contains the information (in some 
embodiments, the information is raw data such as ASCII text) representative of what the user 
entered into the editable sections of a template. The combination of content and template makes 
up the actual web page. Thus, if several web pages are based on a single template, multiple 
content files related to that template are created and stored. To generate the actual web pages, 
each content file is merged with the related template file. 

[0079] The content differentiates the web page based on a particular template, but the 
overall look and feel of all the web pages based on that template remains the same. For example, 
there could be a template for a company's products. This template includes the company's logo 
and links to other pages as aspects common to all web pages based on the template. The 
template further includes an area for a product name and an area for a product description as the 
editable sections, which are the aspects than can change for each web page based on the template. 
Thus, when the user enters content, the user simply types in the product name and the product 
description. Each time the user enters and saves another content file containing the product name 
and description, the user is, in effect, creating another web page. Each page includes both the 
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aspects common to all web pages, provided by the template, and the aspects specific to that 
particular web page, provided by the content. The end result is several different pages for the 
several different products, each of the pages being uniform except for the information specific to 
that product. 

[0080] Once the user has created or changed the web pages, the new or updated web pages 
are "staged" or "published" by sending 206 the web pages to the staging server 108 or the user 
server 1 10. "Staging" means that the templates are merged with the content files to form the web 
pages, and the web pages are placed on the staging server 108 so that the user can review the 
entire site before sending the site to the user server 110. As stated previously, the staging server 
108 can be a separate physical server, a portion of the physical edit server 102, or a portion of the 
physical user server 1 10. The addresses of web pages on the staging server 108 are different than 
the locations of the web pages on the edit server 102 or the user server 110. 
[0081] "Publishing" means that the templates are merged with the content files to form the 
web pages, and the web pages are placed on the user server 1 10 for normal use. As stated 
previously, the user server 1 10 can be a separate physical server or a portion of the edit server 
102. Whether on a separate physical server, or on a portion of the edit server, the addresses of 
the web pages after publishing are different than the locations of the web pages on the edit server 
102 or the staging server 108. 

[0082] A web page can be located at several different addresses. The web page can be on 
the edit server 102 where it is viewed using the user interface, on a local staging server 108 or 
local user server 1 10, or on an external staging server 108 or external user server 110. If the web 
pages are being edited, or the staging server 108 or user server 1 10 are a portion of the edit server 
102, their address will be defined in part by the location of the edit server 102 as well as the web 
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page's location within the edit server 102. If the web page is published to a separate staging or 
user server, the web page's address will be defined by the address of the staging or user server 
and the location of the web page within the staging or user server. Thus, in some embodiments, 
the URLs are modified so that they function correctly when the web page containing the URLs 
are in each of the separate addresses. 

[0083] In some embodiments, if the web pages are published to a user server 110 that is a 
separate physical server, the user has defined a "site base" for the web pages managed by the web 
publishing system 100. The site base is the root of the client's web site. For example, a client 
may have a web site with a root of, "http://www.client.com." This root, 

"http://www.client.com," would be specified by the user as the site base. In this example, a web 
page called "page.html" created by the web publishing system 100 and not being defined as 
within another directory would be located at "http://www.client.com/page.html" after publishing. 
If, during editing, a page "productl.html" were defined as being within the directory "products," 
the page would be located at "http://www.user.com/products/productl.html" after publishing. 
Thus, in some embodiments this site base defines at least part of the web pages' eventual 
address. 

Templates And Content Files : 
[0084] Figures 3(a) and 3(b) show in simple form how the web page information is stored 

before and after staging or publishing. 

[0085] Figure 3(a) is a block diagram illustrating how the templates and content files are 
stored on the edit server 102 prior to viewing on the editing client 104, staging, or publishing. 
On the edit server 102, the template file 302 is stored separately from the content file 304. The 
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template file is created with HTML or other code in some embodiments. When the user creates 
or edits the template file, the communication module 134 receives the created or edited template 
from the client interface module 124 and sends the template to the template update module 126. 
The template update module 126 sends the template to the template module 118, where the 
template is either stored as a new template or, in the case of an edited template, a previously 
stored template is changed. The template module 118 also informs the web page module 114 
when a template is edited. This alerts the web page module 1 14 to not use the cached version of 
web pages based on that template, since the cached version is out of date. Instead, when the web 
page module 114 receives a request for a web page based on that template, the web page module 
1 14 will retrieve the template from the template module 118 and the content from the content 
module 120 and combine them to form the web page. 

[0086] Each content file 304 contains the data added by the user to define a particular web 
page based on a template. As stated previously, as the user creates the template, the user defines 
where content information will be added. When the user creates or edits a content file, the 
communication module 134 receives the created or edited content from the client interface 
module 124 and sends the content, which in one embodiment is an ASCII text file, to the content 
update module 128. The content update module 128 sends the content to the content module 
120, where the content is either stored as a new content file in the database 142 or, in the case of 
editing, a previously stored content file in the database 142 is changed. Additional information is 
stored to link each content file 304 with the proper template file 302. This information may be 
stored by the template module 1 18 in relation to the templates, in the content module 120 in 
relation to content files, in the file structure manager module 115 which stores a relationship 
between each template and content file, in another location, or in a combination of locations. 
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The content module 120 also informs the web page module 114 when a content file is edited. 
This alerts the web page module 1 14 to not use the cached version of the web page that includes 
that content, since the cached version is out of date. Instead, when the web page module 1 14 
receives a request for the web page including that content file, the web page module 114 will 
retrieve the content file from the content module 120 and the template from the template module 
118 and combine them to form the web page. 

[0087] By storing template file 302 separately from content files 304, the template can be 
modified once and, when the web page module 114 generates the web pages by combining the 
template and content files, the changes will be affect every web page based on that template file 
302. 

[0088] In some cases, pages depend on other pages. For example a first page can include a 
list of links to several other pages, as well as the titles of those other pages. When the title of one 
of the other pages is changed, the title listed in the first page should also be changed. The system 
is capable of making such changes automatically. In some embodiments, when the title (or other 
aspect) of one of the other pages is changed, the content module 120 sends an alert to the web 
page module 114 and/or other modules in the system so that the first page will also be changed 
and the revised first page sent to the user server 110 when the revised other pages are sent. In 
other embodiments, the first page is changed to reflect the changed other pages only when the 
first page is formed from the template and content data. In yet other embodiments, both change 
systems are used. 

[0089] Figure 3(b) is a block diagram of the web pages when viewed, staged, or published. 
To initially form the web page 306, the web page module 114 merges a content file 304 from the 
content module 120 with a template file 302 from the template module 1 18 to form the web page 
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306. In some embodiments, the web page module 114 modifies URLs as the web page module 
1 14 forms the web page 306. The web page module 1 14 modifies URLs differently based 
whether the request came from the preview module 130 or the initiate publish module 132, and 
also on how the web page 306 will be viewed. 

[0090] In some embodiments, when the web page module 114 forms the web page 306, the 
web page 306 is stored in cache. This allows the web page module 1 14 to later retrieve the web 
page 306 from cache. This provides greater efficiency than combining the template and content 
each time the web page is viewed, staged or published. 

[0091] When the preview module 130 or the initiate publish module 132 requests the web 
page 306, the web page module 114 determines whether the web page 306 is stored in cache. If 
the web page is stored in cache, and no changes have been made to the content file 304 and the 
template file 302 that formed the web page 306, the web page module 114 retrieves the web page 
306 from cache. However, if either the content file 304 or the template file 302 is changed, the 
content module 120 or the template module 118 notifies the web page module 1 14 so that the 
web page module 114 will not retrieve the web page based on that content file 304 or template 
file 302 from cache. Similarly if a first page with links or other information from other pages 
should be changed because one of the other pages has changed, the web page module 1 14 is 
notified when the other pages are changed and the web page module 114 will not retrieve the first 
web page from cache. Instead, the web page module 1 14 combines the template file 302 and 
content file 304 again. The web page 306 is then viewed through the client interface module 
124, sent to the staging server 108, or sent to the user server 110. 
Access Levels: 
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[0092] As mentioned above, there are higher level users and lower level users. Higher 
level users have access to more features and functionality of the system than lower level users. 
Higher level users create and modify templates and organize the file structure of the web site. 
Higher level users also define to what features and functionality the lower level users have 
access. In some embodiments, the higher level users and lower level users access the web 
publishing system 100 through different user interfaces (UIs). A first interface is for higher level 
users, and allows access to most or all features and functions, and a second interface is for lower 
level users, and allows access to fewer features and functions. More than two levels of UIs may 
also be used. In some embodiments, each user signs in to the web publishing system with a user 
name and a password, and the system automatically provides higher level users with the first UI, 
and lower level users with the second UI. 

[0093] In some embodiments, one or more higher level users define which UI will be 
provided to each user, and what functionality is available through the UIs. For example, in some 
embodiments, users sign in to the web publishing system 100 with a user name and password. 
The higher level users have access to all possible functions through a first UI. The higher level 
users define functionality available to lower level users through one or more lower level UIs. 
The functionality can include allowing lower level users access to only part of the web publishing 
system, allowing lower level users to only enter content related to specified templates, allowing 
lower level users to access functionality only on certain dates or times, or other ways. In the 
example, the higher level users specify what functionality is available to each user by relating 
functionality to user name and password. The higher level user can specify a UI for a lower level 
user that would allow the lower level user to accomplish a specific task, such as creating a 
content file related to a template. Then, after creating the content file, the UI for the lower level 
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user could prevent further action by that lower level user. Thus, the higher level user can set a 
"to do" list for lower level users, and specify a UI that allows the lower level user to accomplish 
the tasks in the "to do" list, and does not allow the lower level user access to any other functions. 
[0094] In some embodiments, the higher level user defines the functionality of a UI for a 
lower level user to be used with a particular template when the higher level user creates that 
template. For example, the higher level user may define additional information that is to be 
provided to the lower level user when the lower level user enters content for that template. 
Further, the higher level user can define commands available for use with relation with a 
particular template. 

[0095] For example, in some embodiments, the users interact with the web publishing 
system 100 through two user interfaces ("UTs), the design UI and the task UI. The design UI is 
the UI for higher level users, and allows the user the ability to use any of the web publishing 
system's tools and functions. These functions include defining access levels for other users, 
creating, previewing, testing, and editing templates, creating and editing content files, and 
creating, previewing, testing, and editing pages. Because the design UI gives the user full access 
to all functions, it is normally be reserved for users such as web administrators and web 
designers. 

[0096] The task UI provides limited functionality. The task UI is normally used by lower- 
level users who are only authorized to perform tasks, often defined by higher level users, such as 
editing the page content of specific pages. A web site administrator or similar higher level user 
determines which tasks a lower-level user may perform. Such lower-level users typically may 
not change a template, nor may they test the page by clicking on a hypertext link. Thus, the task 
UI keeps the lower-level user in a limited functionality area, where the functionality available to 
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the lower level user is defined by the higher level user. For example, the lower-level user may 
only be able to perform the limited task of adding content to specified templates. These users do 
not have to use HTML or other complicated coding languages, so the task UI makes it easy for 
even users of limited skill to provide a valuable service and create web pages based on the 
templates. The user interface module 122 receives the definition of the functionality available to 
each user from the high level users, stores the functionality available to each user, and provides 
that functionality to the users when the users access the edit server 102 through the 
communication module 134. 

Detail Of Creating And Editing Web Pages : 
[0097] Figures 4(a) through 4(h) are screen shots detailing how a user performs operations 

with the web publishing system 100, and illustrating how the web publishing system modifies 

URLs. As noted above, in some embodiments, the user interacts with the web publishing system 

1 00 through two user interfaces ("UI"s), the design UI and the task UI. The user creates 

templates and content files, edits templates and content files, and performs other actions on the 

web site by using one of the two user interfaces. Figures 4(a) through 4(f) show the design UI. 

Figures 4(g) and 4(h) show the task UI. The task UI provides limited functionality. 

Template Creation : 

[0098] Figure 4(a) is a screenshot detailing how a user defines a template. In a navigation 
area 402, the user can access a file organizational structure. This structure can be a file tree, with 
folder and file organization similar to that found on systems such as popular operating systems 
used on both Microsoft Windows and Apple Macintosh systems. Other file organizational 
structures can also be used. With the navigation area 402, the user can navigate through the web 
pages and templates stored in the web publishing system 100, choose to edit existing pages and 
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templates or create new pages and templates, and decide where within the organizational 
structure to store such templates and pages. A command area 404 provides additional functions 
available to the user. 

[0099] In the embodiment shown, the user defines the template by entering HTML code in 
a template code area 406. This HTML code includes special tags, some examples of which are 
listed in Appendix A, below. As stated earlier, the user may hand-code the HTML that 
comprises the template, or use a commercial product that automatically generates the markup 
language code. While defining the template, the user includes code that sets the areas in which 
content will be added, and may also enter default content for these areas. As part of creating the 
template, the user also may enter many different types of URLs as part of the template code, 
including absolute URLs, template relative URLs, and other types of URLs. 
[0100] There are also commands available to the user in the template code area 406. For 
example, the user can preview the template by clicking on the preview button 410, or save the 
template code by clicking on the save button 408 with a mouse. 

[0101] When the user saves the template code, the client interface module 124 sends the 
template code to the communication module 134, which passes the template code to the template 
update module 126. The template update module 126 then passes the template code to the 
template module 118, which saves the code as a template file in the database 138. 
[0102] Figure 4(b) is a screenshot showing a template preview presented to the user after 
the user clicks on the preview button 410 of Figure 4(a). After the user clicks on the preview 
button 410, client interface module 124 sends a preview request to the communication module 
134, which passes the request to the preview module 130. The preview module 130 then sends 
the request to the web page module 114. The web page module retrieves the template file from 
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the template module 118. The web page module 1 1 8 then sends the template file to the 
communication module 134, which sends the template file to the client interface module 124. 
The client interface module 124 then displays the template. As the user is in the design UI when 
previewing a template, the template is displayed nearly the way it would appear as part of a web 
page generated from the template and a content file. However, instead of being combined with a 
content file to form the web page, default content 412 is used. The default content is typically 
created as part of the template file. The default content takes the place of user-entered content 
that would normally appear in a web page generated from combining the template and a content 
file. This allows the user to preview the template without having to also generate a sample 
content file, and shows where the content from the content file would go in web pages based on 
the template. 

[0103] Instead of taking up the entire browser window as the final web page viewed from 
the user server 110 would, the previewed template is seen in a preview area 414. The template 
preview retains the navigation area 402 and the command area 404 so that the user may continue 
to edit the template. This allows the user editing the template to easily determine how the 
template will appear on a viewer's browser, whether the links, such as link 416, work correctly, 
and perform other tests, while remaining within the template creation and editing process and 
having other commands and functions easily available. 

[0104] When previewing the template, the template is on the edit server 102. Eventually, 
web pages that will be generated from the template will be located on the user server 1 10 for 
normal use. This is a different location, either physically or logically, than the edit server 102. 
Thus, URLs in the template, particularly relative URLs in the template, are modified to be 
different when previewed than when viewing the web pages based on that template located on 
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the user server 110. Otherwise, either the template preview or the web page on the user server 
1 10 will not function correctly. Further, since the template preview does not take up the entire 
browser window, the template is targeted to the correct portion of the browser window. 
[0105] Figure 4(c) is a screenshot of a template link preview. A user may test links in a 
previewed template by selecting the links to determine whether they function correctly. After 
selecting link 416 of the template preview of Figure 4(b), the linked page 418 appears in the 
browser window. The linked web page shown in Figure 4(c) is not part of the web site managed 
by the web publishing system 100. Such a page from another site, not part of the web site 
managed by the web publishing system 100, is an external web page. When a link test brings up 
an external web page as seen in Figure 4(c), the navigation area 402 remains, but the command 
area 404 does not appear. Instead, the linked external web page 418 covers the rest of the 
browser window. The command area 404 does not appear since the user may not edit the linked 
external page 418. By not providing a command area 404 relevant to the linked page, the web 
publishing system 100 reminds the user that the user is just previewing the link of the template, 
and may not edit the page. This helps prevent the user from getting confused and attempting to 
edit the linked page 418. In order for the linked external page 418 to appear in the correct 
portion of the browser window, the URL of the linked external page 418 is targeted to the desired 
portion of the browser window. 

[0106] The user may also test a link 416 for a web page that is part of the web site managed 
by the web publishing system 100. A web page managed by the web publishing system is an 
internal web page. When the user tests a link to an internal web page, both the navigation area 
402 and the command area 404 remain. The internal web page appears in the same portion of the 
browser window that the template preview was displayed in. The command area 404 remains 
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since the user may edit the linked internal page. Just as with the external page, the internal web 

page is targeted to the correct portion of the browser window. 

Content Creation, Design UI : 
[0107] Figure 4(d) is a screenshot showing how to create or edit web pages once the 

template has been created. Figure 4(d) shows the design UI, although a user can edit pages using 

either the design UI or the task UI. When creating a web page, the user creates an instance of the 

template that includes content specific to that web page. This content added by the user is saved 

as a content file related to the template. When creating a page, the user sees almost the same 

information as when previewing a template. The browser window includes a navigation area 402 

and a command area 404. Where the template preview included a preview area, the page edit 

includes a web page area 420. The particular web page area 420 shown in Figure 4(d) displays a 

page that has already been created and has content added. A comparison of Figure 4(d) to Figure 

4(b) shows that the default content of the template preview (Figure 4(b)) has been replaced by 

content in the web page preview (Figure 4(d)). To display the web page shown in Figure 4(d), 

the client interface module 124 sends a request to the communication module 134, which passes 

the request to the preview module 130. The preview module 130 then sends the request to the 

web page module 114. The web page module 114 combines the template file from the template 

module 118 with the content file from the content module 120. When generating a web page for 

the page editing view, the web page module 114 includes the page edit symbols 422. The web 

page module 114 then returns the web page to the communication module 134, which sends it to 

the client interface module 124 for display. 

[0108] The user adds content by selecting editable areas on the screen of Figure 4(d). 
When the user created the template, the user defined what areas of the template where content 
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will be added to create each page. Each of these areas is marked by the page edit symbol 422 in 
the page editing view. To add content and create a page, or to add information or edit an existing 
content file, the user selects the page edit symbol 422. 

[0109] As with Figure 4(b), in Figure 4(d) the web page in the web page area 420 has a 
different URL and location than the template on which the web page is based. Thus, URLs in the 
template, particularly the various relative URLs in the template, are modified to be different in 
the template than the corresponding URLs in the web page based on that template so that both 
the web page and the template preview function correctly. Further, the web page is targeted to 
the correct portion of the browser window. 

[0110] Figure 4(e) is a screenshot showing how a user enters content to create a content file 
for a web page after selecting the page edit symbol 422. The content entering screen includes the 
navigation area 402 and command area 404, as well as a content entering area 424. Information 
427 on the content entering screen also shows the identity and location within the file structure of 
the page for which the content is entered. The user may define where in the file structure the 
page based on the content will be stored, or may define where all pages based on a certain 
template will be stored. In different embodiments, this can be done when the template associated 
with the content files is created, when the content file is created, or at other times through use of 
the file structure manager module 115 to govern the overall file structure. When entering content 
to create a content file for a web page, a user needs little or no knowledge of HTML. In the 
example of Figure 4(e), the user simply types the information into labeled fields. The 
information entered in this page forms the content file of a web page, as opposed to the template 
information that is common to each page based on that template. For example, in the field 
labeled, "Member_Name" 426 the user types in the name. As seen in Figure 4(e), this is a 
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straightforward operation. After typing in all the content, the user clicks on the "Save" button 
428. This causes the client interface module 124 to send the content information that the user 
entered to the communication module 134. The communication module 134 sends the content 
information, in the form of a content file, to the content update module 128. The content update 
module 128 then sends the content file to the content module 120, where the content file is stored 
in the database 142. The user can also delete or edit the content on this screen, and save the 
revised content. Thus, creation and editing of the pages is a very simple task. 
[0111] Figure 4(f) is a screenshot showing a page preview. After the content is entered into 
a page, the user may preview the page to ensure it looks correct. A page preview, as shown in 
Figure 4(f), is similar to a template preview, shown in Figure 4(c). However, in the page 
preview, the web page displayed includes the template file combined with the content file for the 
web page, instead of just default content. To preview the page, the web page module 114 merges 
the template file from the template module 118 with the content file from the content module 120 
to form the web page. The web page module 114 then sends the web page to the communication 
module 134. The communication module 134 sends the web page to the client interface module 
124, which displays the web page for the user. 

[0112] When using the design UI, the user may perform tests such as checking the links to 
make sure they function correctly. As when previewing the template, when previewing the page 
the design UI presents the user with the page the way it would be seen in a web browser, with the 
exception that the previewed page is seen in a page preview area 430 instead of the entire 
browser window. The page preview retains the navigation area 402 and the command area 404 
so that the user may continue to edit the page. The page preview allows the user editing the page 
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to determine how the page will appear on a viewer's browser, whether the links work correctly, 
and perform other tests, while remaining within the page creation and editing process. 
[0113] As with Figure 4(d), in Figure 4(f) the web page seen in the page preview area 430 
has a different location than the template on which the web page is based. Thus, URLs in the 
template, particularly relative URLs in the template, are modified to be different in the template 
than the corresponding URLs in the web page based on that template so that both the web page 
and the template preview function correctly. Further, the web page is targeted to the correct 
portion of the browser window. 

[0114] If an external link were selected, the external web page would be displayed in a 

different portion of the browser window. The navigation area 402 would remain, but the 

command area 404 would not. This prevents the user from becoming confused and attempting to 

edit the external web page. 

Content Creation, Task UI : 
[0115] Figure 4(g) is a screenshot illustrating how the user creates or edits a page using the 

task UI. The task UI only provides limited functionality. This limited functionality can be 

defined by a higher level user, or the system can have predetermined function sets available to 

each level of user. The task UI is normally used by lower-level users who are authorized to 

perform specific tasks such as adding page content to specific pages. The administrators 

determine which tasks a lower-level user may perform. The task UI does not allow a user to 

change the template or test the page by clicking on a hypertext link. If a user clicks on a link, the 

web publishing system 100 will present the user with a message stating that the links have been 

disabled. To do this, when the web page module 114 combines the template file and content file, 
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the web page module 114 modifies the URL of the link so that the linked page is not loaded. 
Instead, the link URL is modified so a message indicating the links have been disabled is loaded. 
[0116] Thus, the task UI keeps the lower-level user in a limited functionality area where the 
lower-level user can only perform limited tasks such as adding content to web pages. Users who 
access the web publishing system 100 through the task UI typically know little or no HTML. 
Thus, these users do not have access to the underlying template markup language code. 
[0117] In keeping with its limited functionality, the task UI does not present the user with 
as much information as the design UI does. The task UI includes a task command area 432 and a 
page edit area 434. The page edit area 434 in the task UI includes the same information, 
including the same page edit symbols, as the page area 420 shown in Figure 4(d). 
[0118] To display the page in the page edit area 434, the web page module 114 merges the 
template with that page's specific content file. The web page module 1 14 also modifies the 
URLs in the template and content files as needed. 

[0119] To edit and add content to the page, the user selects the page edit symbol 422. The 
user then enters content in the same manner as shown in Figure 4(e), with the exception that in 
the task UI, neither the navigation area 402 nor the command area 404 is displayed. Instead, the 
content entering area 424 is the only area shown in the user's browser window. The higher level 
user defined the content fields when the higher level user created the template file. Just as in the 
design UI, the content added by the user is saved in the content file for that page. 
[0120] Figure 4(h) is a screenshot showing a page preview using the task UI. To provide 
the page preview, the web publishing system 100 combines the content file for that page with the 
template. The page preview of the task UI presents the user with a task command area 432 and a 
page preview area 430. The page preview in the task UI provides the limited functions of giving 

Case 21540-05799 34 



a user the ability to determine how the page currently being edited would appear on a viewer's 
browser. Since the task UI provides limited functionality, the page preview in the task UI does 
not include a navigation area 402. The task UI also does not allow a user to change the template 
or test the page by clicking on a hypertext link. If a user clicks on a link, the web publishing 
system 100 will present the user with a message stating that the links have been disabled. To do 
this, the web page module 1 14 modifies the URL of the link so that the linked page is not loaded. 
Instead, the web page module 1 14 modifies the link URL so a message indicating the links have 
been disabled is loaded. 

URL Modification : 

[0121] In some embodiments, the web publishing system 1 00 includes functionality for 
modifying URLs or other indirect addresses. As is apparent from the discussion above, the web 
page module 1 14 of the web publishing system 100 may modify URLs in many different 
situations. The user typically enters many different URLs of different types during the creation 
of the template or content. The URLs from both template and content are modified based on the 
type of URL, what context the web page exists in, and which UI is being used by the user. 
[0122] Figure 5 is a flow chart showing a URL modification process. When a template and 
content are combined, the web page module 114 modifies the URLs in the resulting web page as 
needed. The web page module 114 determines the context 502 in which the web page will 
appear. There are four contexts: template preview, page preview, local stage or publish, and 
external stage or publish. 

[0123] A template preview shows a preview of the template. A page preview shows a 
preview of the web page. Thus, the page preview includes both the template and content. The 
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user views the template preview or the page preview via one of the two user interfaces, the 
design UI or the task UI. When viewed via one of the user interfaces, the previewed template or 
page is located on the edit server 102. Figure 4(b) shows a template preview, and Figures 4(d), 
4(f), 4(g), and 4(h) show page previews. 

[0124] When a web page is staged or published, either locally or externally, the web page is 
not viewed via the user interface. Rather, the web page module 114 forms the web page 
combining the template and content, and then sends the web page via the publish module 1 16 to 
the staging server 108 or the user server 1 10. From the staging server 108 or the user server 110, 
the web page is viewed by viewing clients 112. Thus, under the local and external staging and 
publishing contexts, the location of the web page depends on the location of the staging server 
108 or the user server 110. 

[0125] The web page module 1 14 also determines the URL type 504 of each URL within 
the content file and template file that make up the web page. There are six URL types: absolute, 
site relative, template relative, page relative, system relative, and same page link. The web page 
module 114 determines the URL type because the six URL types are modified in different ways. 
[0126] The web page module 1 14 determines the user interface 506 (design UI or task UI), 
if any, used to view the web page. If the web page is part of a template preview or page preview, 
the web page will be viewed via a user interface. URLs are modified differently based on the 
user interface used to view the web page. 

[0127] The web publishing system determines whether the URL is a page load URL 508. 
A page load URL links to another web page and normally causes the browser to replace the 
current page with the linked page or bring up a new browser window. If the URL is a page load 
URL and the web page is viewed through one of the two user interfaces (the design UI or the task 
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UI), the URL is modified. The URL is retargeted, and, in the case of the task UI, the link URL is 
modified to link to a message stating that links have been disabled, as seen in Figure 4(c) and the 
discussion of Figure 4(c), and in the discussion of Figure 4(g). 

[0128] Finally, the web publishing system 100 modifies the URL 510. Modifying the URL 
includes one or both of rewriting the URL or retargeting the URL. The URL is modified based 
on the context of the web page that contains the URL, the URL type, the user interface used to 
view the web page that contains the URL, and whether the URL is a page load URL. In some 
cases, the URL is not modified. 

[0129] Figures 6(a) through 6(c) and 7 comprise a chart that details how the URLs are 
rewritten and retargeted. The chart 600 of Figures 6(a) through 6(c) begins in Figure 6(a). The 
input 602 to the chart 600 is a URL that may have to be rewritten. This URL is input as a result 
of the web page module 114 combining a template from the template module 118 and a content 
file from the content module 120 into a resulting HTML document. Each URL encountered in 
the combining process, whether from the template or the content, is processed in the steps 
described in the following paragraphs and shown in Figures 6(a), 6(b), 6(c), and 7. The URL is 
checked to determine if the URL is of a type that would cause a page to load 604. In one 
embodiment, URLs within the "<a href>," "<area href>," and "<form action>" HTML tags are 
recognized as page load URLs, unless they link to the same page. If the URL is recognized as a 
page load URL, the URL may be modified 606, as detailed in chart 700 of Figure 7. In some 
cases, the URL is then returned from the chart 700 of Figure 7. 

[0130] If the URL is not recognized as a page load URL or has been returned from the 
chart 700 of Figure 7, the web publishing system 100 determines if the URL is an absolute URL 
608. Absolute URLs have the complete address, so the web publishing system 100 treats 
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complete URLs as absolute URLs. If the URL is an absolute URL, the URL is not rewritten 610. 
This is because absolute URLs work correctly no matter their location, since they include the 
complete address of the referenced item. 

[0131] The URL is checked to determine if the URL is a site relative URL 612. The web 
publishing system 100 recognizes URLs that begin with a slash ("/") as site relative URLs. If the 
URL is a site relative URL, the context is checked 614 to determine if the context is that of an 
external publish. If the context is an external publish, the URL is not rewritten 610. This is 
because the user writes site relative URLs in the web publishing system 100 as being relative to 
the final location of the web site, which is the external published site. Thus, if the context is an 
external publish, the URL does not have to be rewritten in order to function correctly. 
[0132] If the context is not an external publish, whether a site base for the web site has 
been specified is determined 616. If the site base has been specified, the site base is added to the 
site relative URL so that the site relative URL is rewritten as an absolute URL 61 8. That way, 
the rewritten URLs will reference the correct location on the user server 110. 
[0133] If the site base has not been specified, the site relative URL is rewritten as a 
document relative URL 620. This is because the site relative URL is rewritten under the 
assumption that the site root on the edit server is the same as the site root on a local user server. 
For example, "/images/logo. gif ' might be rewritten as "../logo.gif " If the URL is not a site 
relative URL, the URL is sent to Figure 6(b) 622. 

[0134] Figure 6(b) is a continuation of the chart 600 of Figure 6(a). The URL enters from 
Figure 6(a) 622. The URL is checked to determine if the URL is a template relative URL 624. 
Document relative URLs in a template file are assumed to be template relative URLs, if no other 
identifying marks are present. If the URL is a template relative URL, the context is checked to 
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determine if the context is that of a template preview 626. If the context is that of a template 
preview, the URL is correct and is not rewritten 630. This is because template relative URLs 
specify a location relative to the template, and the displayed template preview is in the correct 
location for these template relative URLs to function correctly. If the context is other than a 
template preview, the template relative URL is rewritten as a document relative URL 628. The 
web publishing system 100 does this by expanding the template relative URL to the full path, 
then reducing the URL to a page relative URL. 

[0135] For example, a template is located at "/templates/tmpl.pbt" and contains an image 
URL written as "../images/logo.gif." The page based on the template exists at 
"/news/recent/page.htm." The web publishing system 100 modifies the image URL when the 
page is created so that the image URL still references the same image. First, the image URL 
from the template is changed to, "/images/logo.gif." Then, the image URL is rewritten so that it 
references the same image from the page location. The new image URL is, 
"../../images/logo.gif." 

[0136] The URL is checked to determine if the URL is a page relative URL 632. Page 
relative URLs are identified with a marking code. Preferably, page relative URLs are identified 
with the marking code of an exclamation point ("!"). If the URL is page relative, the marking 
code is removed from the front of the URL and the URL is otherwise left untouched. This allows 
the page relative URL to function correctly in its location in a web page. However, the page 
relative URL will generally not function correctly in a template preview, since the page relative 
URL references a file in relation to the final web page location, not the template location. If the 
URL is not a page relative URL, the URL is sent to Figure 6(c) 636. 
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[0137] Figure 6(c) is a continuation of the chart 600 of Figure 6(b). The URL enters from 
Figure 6(b) 636. The URL is checked to determine if the URL is a system relative URL 638. 
System relative URLs are identified with a marking code. Preferably, system relative URLs are 
identified with the marking code of "pub:". If the URL is a system relative URL, the URL is 
rewritten as a document relative URL 640. To rewrite the system relative URL, the "pub:" is 
removed. The rest of the URL is a site-relative URL, which is relative to the top of the publish 
system. The top of the publish system is not necessarily the same as the top of the actual site. 
Thus, next the same modification as detailed above with respect to template relative URLs. The 
web publishing system 100 expands the URL to the full path, then reduces the URL to a page 
relative URL. 

[0138] If the URL reaches this point and has not modified the URL or determined that no 
modification is necessary, the URL is either a same page link or a type of URL the web 
publishing system 100 does not recognize. In either case, the web publishing system 100 does 
not rewrite 642 the URL. 

[0139] Figure 7 is a chart 700 detailing the function of determining whether the URL needs 
to be retargeted, and if so, retargeting the URL. The page load URL is first input 702. The 
context is checked 704 to determine if the context is a staging or publishing context, either local 
or external. If the context is a staging or publishing context, the URL is not retargeted 706. The 
unmodified URL is output 708 back to the URL rewriting chart of Figure 6. 
[0140] If the context is not a staging or publishing context, the user interface is checked to 
determine whether the page load links should be suppressed 710. If the user is using the task UI, 
the page load links should be suppressed. Otherwise, the page load links should not be 
suppressed. If user is using the task UI and the page load links should be suppressed, the page 
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load URL is replaced 712 with a notification URL. A notification URL is a link to a notification 
message stating that the link has been disabled. As a result of the notification URL, when the 
user clicks on a page load link in the task UI, the user will be presented with a notification that 
links have been disabled in the task UI. After the URL has been replaced with a notification 
URL, no further processing need be performed 714 on that URL. The URL is not returned to the 
rewriting chart, since the URL already has been completely rewritten. 
[0141] If the page load links should not be suppressed, the URL is retargeted 716. 
Retargeting URLs provides the advantages of presenting the page in the correct part of the 
browser window and signaling the web publishing system 100 that a page has been loaded. 
Preferably, the URL is retargeted only if the URL does not already have a target specified, so that 
if the URL is an external URL that targets its own window, the targeted external URL works 
properly. As shown in Figure 4(c), when a user links to another page, the linked page does not 
take up the entire browser window. Instead, the URL is retargeted so that the linked page 
appears in one area of the browser window, and a navigation area 402 remains in the rest of the 
window. Internal URLs are retargeted differently than external URLs, as described with respect 
to Figure 4(c), above. In order to place the linked page in the appropriate browser window area, 
the target attribute of the linked page is changed to the correct frame. Further, when a URL is 
retargeted, a parameter is also added to the URL to capture the fact that a new page was loaded. 
When the web publishing system 100 sees this parameter, it knows a new page was loaded via a 
link and can update the user interface and internal state as needed. After being retargeted, the 
modified URL is output 708 back to the URL rewriting chart in Figure 6(a). 
Automatic Linking/ Automatic Content : 
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[0142] One feature, found in some embodiments, is the automatic linking of documents 
and the automatic inclusion of content in documents. In one aspect, a document is automatically 
linked to other documents. Alternately, content from other documents is automatically included 
in a document. In another aspect, links are automatically created within a single page. 
Alternately, content from within a page is listed or otherwise presented again on that same page. 
The following description provides a general description of automatic linking. Appendix II 
provides more detail on how automatic linking is accomplished in one embodiment of the 
invention. 

Linking to Other Pages : 

[0143] Some embodiments where links to other web pages are automatically generated use 
the location of the other web pages to accomplish that link generation. Figure 8 is a block 
diagram showing a simplified overview of an embodiment of a file organizational structure. File 
organizational structures are well known in the art. In the file organizational structure shown in 
Figure 8, the general structure is that of folders and files. A first folder 802 (also labeled as 
"folder 1" in Figure 8) is the top level of the organizational structure. The first folder 802 
contains documents 804, 806, 808, and 810 and other folders 812, 814, 816 and 818. The folders 
812, 814, 816 and 818 may in turn contain documents, other files, and other folders. This can be 
seen with the fifth folder 818 (also labeled as "Folder 5" in Figure 8). The fifth folder 818 
contains documents 822, 824, 826, and 828, as well as a sixth folder 820 (also labeled as "Folder 
6" in Figure 8). The sixth folder 820, in turn, can contain still more documents, files and folders. 
[0144] The web publishing system 100 organizes the web pages created in a similar 
organizational structure. Content files can be treated as web pages for organizational purposes, 
since it is known which template the content files will be merged with to form the web pages. 
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Thus, the content files can be treated as having the same location within the organizational 
structure as the web pages that will result from the merging of the template with that content file. 
Thus, the web pages and content files are treated as being within folders in an organizational 
structure. The user can see where in the organizational structure content files/web pages are 
stored by using the navigation area 402, shown in Figures 4(a) and other Figures. The navigation 
area 402 shown in Figure 4(a) shows one top-level folder. The user can click on the top-level 
folder to see the files and folders within that top-level folder. The user can then click on folders 
within the top-level folder to see the contents within those folders. The file structure manager 
module 115 stores the organization of the files used in the web publishing system 100. 
[0145] The user determines where in the organizational structure web pages will be 
located. In one embodiment, when creating a template, the user may define where the web pages 
based on that template will be located. In another embodiment, when entering content, the user 
may define the location for the web page that contains that content. In another embodiment, the 
user may specify and change the location of the web pages and content files after their creation. 
This can be done by such well-known methods as navigating through a graphical representation 
of the organizational structure, and "dragging and dropping" the files to the desired location, or 
"cutting and pasting" the files to the desired location, or through other methods. In yet another 
embodiment, the user could use all of the aforementioned methods for determining the location 
of the web pages as desired. 

[0146] As each document - template file, content file, or web page - is created, deleted, or 
changed, the file structure manager module 115 tracks the creation, deletion or change. In some 
embodiments, the file structure manager module 115 also automatically causes other contents to 
make changes based on the first change, if necessary. 
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[0147] Figure 9 is a block diagram showing an example of how links to other documents 
are automatically generated in a document. As seen in Figure 9, a document 902 (the "list 
document" 902) includes a list of links 904, 906, 908, and 910 to other documents 916, 918, 920, 
and 922 ("linked documents"). The linked documents 916, 918, 920, and 922 are located in 
folder 914. When a new linked document 924 is added to folder 914, a new link 912 to the 
linked document 924 is automatically added to the list document 902. 

[0148] In one embodiment, the linked document 902 is created as follows. When the user 
creates the template for the list document 902, the user defines what documents will be linked. 
In some embodiments, this is done by specifying the location of the linked documents within the 
file organizational structure. Thus, when creating the template for the list document 902 in 
Figure 9, the user specifies that the linked documents will be in folder 914. Then, when the list 
document 902 is formed by combining the template with a content file, the web page module 114 
reads the specification for the location for the linked documents. The web page module 114 then 
retrieves the proper links for the linked documents from the file structure manager module 115, 
and adds the links to the resulting web page. If the template for the list document 902 specifies 
that the list will include all documents in folder 914, for example, the web page module 114 will 
send a request to the file structure manager module 1 15 for the locations of all the documents in 
folder 914, and create links to those documents in the list document 902. 
[0149] The user can specify the linked documents in other ways than just a single folder 
location. The user can specify linked documents in ways other than location, also. The user can 
specify one or more locations in the organizational structure, names or partial names (with wild 
cards, such as any files that have names that begin with a particular letter), files by dates (the ten 
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newest files), or by other identifying features. The user can also specify that a random selection 
of documents, or a random subset of documents otherwise specified, be linked. 
[0150] In addition to specifying the linked documents, the user specifies how the linked 
documents will be identified in the list document 902. For example, if the linked documents are 
web pages formed from content files that include a "title" field, the user can specify that the text 
from the title field be shown in the list document, and that the text is a hypertext link to the 
linked document. In some embodiments, the list document 902 is created with just a list and no 
links. Using the above example, the list document 902 lists titles of specified web pages, but no 
links to the specified web pages. 

[0151] The user may also specify the length and organization of the list in the list document 
902. For example, the user specifies how the list will be sorted (for example, alphabetically by 
linked document title, by date of the linked documents' creation, randomly, or otherwise), the 
direction of sorting (for example, alphabetically A-to-Z or Z-to-A, or otherwise) and how many 
linked document links to display (for example, all documents, the most recent ten documents, 
documents selected at random, or otherwise). 

[0152] In some cases, no other documents may meet the specification for linked 
documents. The user may define information or content that is to be displayed in such a case. 
Then, instead of having a blank document when no documents meet the specification, the user- 
defined information or content is displayed. 

[0153] To remain accurate, the list page 902 should be updated when linked documents 
meeting the specifications for documents to be listed on the list page 902 are added or changed. 
In some embodiments, the list page 902 is updated when the user specifies that the list page 902 
should be published. When this occurs, the web page module 114 forms the list page 902 from 
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the template and content files. The web page module 114 reads the link specifications in the 
template file for the list page 902 and retrieves the relevant files to be linked and their locations 
from the file structure manager module 115. The web page module 114 then inserts the links to 
the linked documents locations into the web page formed from the template and content files. 
[0154] In other embodiments, the file manager structure module 115 searches all the 
templates in the system whenever a content file is created or changed. The file manager structure 
module 115 determines whether the new or changed content should be reflected in any list 
documents 902. If so, the file manager structure module 115 sends instructions to remove the 
current version of the list document 902 from cache, so that the next time the list document 902 
is needed, it is formed anew with the correct list of links instead of retrieved from cache. The file 
manager structure module 115 may also immediately cause the web page module 1 14 to form the 
list document 902 with the correct list of links and send the list document 902 to the publish 
module 116, which sends the list document 902 on to the user server 110. Alternately, the web 
page module 1 14 may wait until the created or changed linked documents are published on the 
user server 1 10 via the publish module 116, and automatically publish the new, correct list 
document 902 at the same time. 

[0155] Such link pages 902 can also be automatically formed in systems that do not follow 
the template/content scheme. In such systems, the link page would still include a specification 
for which pages to link to. A file manager structure module 115 can track when pages meeting 
the specification are saved in the system, and automatically trigger the updating of the link list in 
the link page. Thus, when a page is created by a user, and the user selects a "save" command, the 
page is saved. The file manager structure module 115 also automatically checks the files in the 
system to see if the saved page meets the specification within link pages. If so, the link page is 
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automatically updated. This is particularly useful when linking to non-HTML content such as 
multimedia files (sound files, movie files, etc.), and text documents (documents in .pdf format, in 
Microsoft Word format, etc.). 
Linking Within a Page : 

[0156] Some embodiments of the web publishing system 100 are also able to automatically 
create a list of links to locations on the same document in which the list of links appears. This is 
generally useful when a single document contains more information than can be shown on the 
screen at once. By including links to locations on the same document, a user may jump directly 
to desired information rather than searching or scrolling through the document. One common 
example of such a document is a "FAQ" (Frequently Asked Questions) document, where there is 
a list of questions at the top of a document such as a web page. Each question is a hypertext link 
to text providing the answer to that question elsewhere on the same web page. The list of links 
acts as an index to the information located elsewhere on the web page. Thus, such a document is 
an "index" document. 

[0157] Figure 10 is a diagram of such an index document 1002. The index document 1002 
includes an index with links 1004, 1006, and 1008 to locations elsewhere on the index document 
1002. In the illustrated embodiment, the links 1004, 1006, and 1008 are hypertext links where 
the text is the title of three topics. Below the links 1004, 1006, and 1008, in three separate 
locations 1010, 1012, and 1014 on the index document 1002, is information on each of the three 
topics. When a user wished to see information on the first topic, the user clicks on link 1 004, 
which takes the user to location 1010, where there is information on the first topic. The user can 
similarly access information on the other topics. 
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[0158] Such same page links are useful because in some index documents 1002, there are a 
large number of topics with information (or similar type data structures), which make finding the 
desired information difficult without such a list of links. 

[0159] In some embodiments, the index document 1002 is created as follows. The format 
of the content to be added, such as the information on the topics at locations 1010, 1012, and 
1014 in the index document 1002, is defined when the user creates the template for the index 
document 1002. One way to define the format is to allow a loop of content entries. A loop of 
content entries is where the user defines a field or fields for content to be added, and also 
provides a special tag allowing that field or those fields to be repeated. Then, when creating the 
content file based on that template, the user may reuse the fields to add information as many 
times as the user wishes. Each reuse of the fields is a separate data piece. 
[0160] One example of this is a web page with a list of locations for a chain of retail stores. 
The template would include a field for an address, and specify that the field may be repeated. 
When creating the content file, a user would then enter as many addresses as there are locations 
for the stores. The resultant web page would list each address. Such a field, or multiple fields 
that allow multiple instances of content during creation of the content file is called a loop. Each 
address, in this example, is an instance of the looped fields. Each time the user adds an instance 
of the looped fields, the user adds a new piece of data for which an entry in the index may be 
generated. 

[0161] To provide an index in the index document 1002, includes a special tag in the 
template file. This tag specifies that there is a loop in the web page based on the template file. 
When the web page module 114 forms the web page from the template file and a content file, the 
web page module 1 14 creates an index with information from each instance of the loop fields. 

Case 21540-05799 48 



[0162] The user has the freedom to specify characteristics of index when the user creates 
the template file. For example, while Figure 10 shows the index document 1002 as having an 
index with links 1004, 1006, and 1008 to the locations on the index document 1002, the index 
may only include the titles of the topic, without links to the information on the topics. In an 
example of such a case, the user defined a loop with a title field and an information field. When 
a user created the content file, the user entered one or more titles and information related to the 
title. Then, when the web page module 1 14 forms the web page, the web page module creates 
the index from each of the title fields. Thus, the user can specify an index with or without links 
when creating the template. 

[0163] Similarly, the user can specify a subset of the instances of the looped fields to be in 
the index. For example, the looped fields may be an alphabetical phone list, with names and 
phone numbers. The index for the web page may contain only the names that begin with the 
letter "A," with links to the appropriate locations on the page. 

[0164] Unlike the case where a page includes automatically generated links to other pages, 
in the case of an index in an index document 1002, the file structure manager module 1 15 does 
not have to track changes to each content file for possible changes to other pages that link to the 
web page formed from the content file. The index document 1002 is self contained; the links that 
are automatically generated only link to the same page. Thus, when a user changes the content 
file for the index document 1002 and publishes it, the web page module 1 14 will combine the 
template file and content file and correctly automatically generate the index and, if required, the 
links. 

[0165] In some cases, the document may not have any instances of the looped fields that 
meet the specification for index entries. The user may define information or content that is to be 
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displayed in such a case. Then, instead of having a blank index when no instances meet the 

specification, the user-defined information or content is displayed. 

[0166] While the list page 902 and the index document 1002 have been described as 

separate documents, some pages may be both a list page and an index document. Such a page 

will have automatically generated links to other pages as well as an automatically generated 

index. 

[0167] While the invention has been particularly shown and described with reference to 
some embodiments, it will be understood by persons skilled in the relevant art that various 
changes in form and details can be made therein without departing from the spirit and scope of 
the invention. 
[0168] Appendix I 

[0169] This Appendix I includes a list of tags used in one embodiment to the invention. In 
other embodiments, additional tags may be used, entirely different sets of tags may be used, or a 
scheme different than HTML-style tags may be used. The tags listed below function in a manner 
similar to those of normal HTML tags. The tags generally have a beginning tag and an 
associated ending tag that together enclose an area of the document modified by the tags. Each 
tag may have a set of attributes, that identify or modify the tag, or modify the user interface 
created by that tag. The tags: 

<publish-a> 

<publish-edit-marker> 

<publish-file-index> 

<publish-if-file-index-empty> & <publish-if-file-index-not-empty> 

<publish-form-control> 

<publish-form-option> 

<publish-get> 

<publish-group> 
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<publish-if-cross-post> and <publish-if-not-cross-post> 

<publish-if-empty> and <publish-if-not-empty> 

<publish-if-loop-empty> and <publish-if-loop-not-empty> 

<publish-img> 

<publish-include> 

<publish-index-anchor> 

<publish-index-file> 

<publish-index-link> 

<publish-loop> 

<publish-loop-count> 

<publish-loop-counter> 

<publish-loop-index> 

<publish-lt> & <publish-gt> 

<publish-meta> 

<publish-rewrite> 

<publish-text> 

<publish-title> 

[0170] <publish-a> </publish-a> 

[0171] Used to add HTML links and anchors to templates. Either a pbname or a 
pb source attribute is mandatory. 

[0172] Attributes of <publish-a> tags: pbname , pbsource , pblabel , 
pblabel_xxx, pbeditmarker , pbeditmarkerdirection, pbhide, 
pbcontrol, href, name, target, other 

[0173] pbname : The pbname attribute is mandatory if the content of the <publ i sh- 
a> tag is editable. The value of the pbname attribute must be a unique name. 

[0174] pbsource : The value of this attribute must be set to the value of a pbname that 
belongs to another <publish-a> tag on the template (unless it's inside a 
<publish- f ile- index> ? in which case, it must refer to the pbname of a tag 
on the indexed pages.) When pbsource is specified, the <publish-a> tag will 
not be editable and it won't appear on an edit- form. 
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pb label : pb label attributes help create user-friendly URL edit-fields on edit- 
forms. The value assigned to the pblabel will appear above the edit-field created 
for the publish -a tag. This can be used to provide additional information as to 
how a specific field in a template should be used when adding content. 
pblabel_xxx: The pblabel_xxx attribute allows you to add labels for each 
edit-field generated by an editable attribute. These labels can help clarify the 
expected input or offer brief instructions to people entering information in the edit- 
form. The _xxx is just a placeholder for the name of the attribute that you would 
like to create a label for. Labels generated with pblabel_xxx attributes will 
appear to the right of the edit-fields on the edit-form. If the pblabel_xxx 
attribute is omitted, a default label will be generated based on the HTML attribute 
name. 

pbedit marker : This optional attribute determines whether the orange edit- 
marker will appear beside the edit-field in the Edit-Marker mode or not. If 
pbedit marker is omitted, the value will default to yes and the edit-marker will 
appear. If the value of pbeditmarker is set to no, the edit-marker will not show up. 
pbeditmarkerdirect ion : This attribute control which way the arrow in the 
orange edit-markers points. It can take four possible values: left, right, up or down. 
If the attribute is omitted, the value defaults to right. 

pbhide: This attribute hides the output of an editable template tag. <publish- 
a> tags which have a pbhide attribute set Xoyes will allow users to edit the 
content of the <publish-a> tag, but that content will not be passed to the pages 
created with that template. The default value of pbhide is no. 
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[0180] pbcontrol : The pbcontrol attribute specifies that the <publish-a> tag 

should draw its content from a pull-down menu created with a <publish- f orm- 
control> tag. You must have or include a <publish-f orm- control > on 
your template to use this attribute. 

[0181] href: This attribute specifies the target URL. Use an asterisk to make the href 
attribute editable. Any path information that follows a * will be used as the default 
value. 

[0182] name: The name attribute defines the scroll position. Use an asterisk to make this 
value editable. Any name information that follows the * will be used as the default 
value. 

[0183] target: Use an asterisk to make the value of the target attribute editable. Any 
name information that follows the * will be used as the default value. 

[0184] other: All other attributes can be set to be editable with an asterisk. Any 
information that follows the * will be used as the default value. 

[0185] <publish-edit-marker>. . .</publish-edit-marker> 

[0186] Used by the template designer to specify the location of an edit symbol (also known 
as an edit marker) for a tag or group. The pbname attribute is mandatory. 
[0187] Attributes of <publish-edit-marker> tags: pbname , 
pbeditmarkerdirection 

[0188] pbname : The pbname attribute is mandatory. The value of this attribute must be 
set to the value of another pbname on the page. 
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[0189] 



pbeditmarkerdirection : This attribute control which way the arrow in the 
orange edit-markers points. It can take four possible values: left, right, up or down. 
If the attribute is omitted, the value defaults to right. 



[0190] <publish-file-index> . . . </publish-file-index> 

[0191] The <publish- f ile- index> tag creates a list of records from content that is 
located on other pages of the site. The pbsourcef iles attribute is mandatory. 
[0192] Attributes of <publish-f ile-index> tags: pbsourcef iles, 
pbsortname, pbsortf ormat , pbsortdirection, pbmaxitems, pbfilter, 
pbf iltername 

[0193] pbsourcef iles : The pbsourcef iles attribute specifies which files should 
be considered when building the file-index. The value of this attribute may include 
wildcards or several file specifications (different paths must be separated by semi- 
colons). 

[0194] pbsortname : The pbsortname attribute allows a template designer to sort a 
file-index according to the contents of a specific edit-field. pbsortname should 
be assigned the value of the pbname of the edit-field that should determine how the 
file-list is sorted. If this attribute is omitted, the file-index will default to be sorted 
by filename. You may use up to ten pbsortnames (pbsortname, pbsortnamel- 
pbsortname9) to specify multiple sort fields. 

[0195] pbsort format : This attribute controls the type of sort performed. It may be 

assigned a value of either text or number. If this attribute is omitted, the value will 
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default to text. You may use up to ten pbsortformats (pbsortformat, pbsortformat 1- 
pbsortformat9) to specify multiple sort formats. 
[0196] pbsortdirection : This attribute controls the direction of a sort. It maybe 
assigned a value of either ascending or descending. If this attribute is omitted, the 
value will default to ascending. You may use up to ten pbsortdirections 
(pbsortdirection, pbsortdirectionl-pbsortdirection9) to specify multiple sort 
directions. 

[0197] pbmaxi t ems : This attribute can be set to an integer that determines the 
L , maximum number of entries displayed in the file-index. This allows the file-index 

Q to have fewer entries than the actual number of files. If the pbmaxi terns attribute 

)0 is omitted, all files that match the pattern will be indexed. 

m [0198] pbf ilter : The pbf ilter attribute allows you to filter the content of a file- 

Sss? " 

p index based on the values in a particular field (which may be specified with a 

O pbf iltername attribute). Filter expressions start with an operator (~ or > for 

z 

Q example) that indicates the type of comparison. All comparisons are alphabetic (or 

ITS ii 

"{text}" based)- "A" is less than "B" and "100" is less than "20" (though not less 
than "020") and case-sensitive by default. You can change this default with the 
options "{nocase}" and "{number}". 
[0199] pbf iltername : This is the name of the field used for filtering. If this is omitted 
then filtering defaults to the pbsortname field. To do filtering, either 
pbf iltername or pbsortname must be present. 
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[0200] <publish-if-file-index-empty> ... </publish-if-file-index-empty> 
<publish-if-file-index-not-empty> . . . </publish-if-file-index-not-empty> 
[0201] Encloses HTML that is included on templated pages depending on whether or not 
any files meet the criteria defined in the value of the pbsourcef iles attribute. The 
pbsourcefiles attribute is mandatory. 

[0202] Attributes of <publish-if -f i le- index- empty > and <publish-if - 
f ile-index-not-empty> tags: pbsourcefiles 

[0203] pbsourcefiles : The pbsourcefiles attribute specifies which files should 
be considered when building the file-index. The value of this attribute may include 
wildcards or several file specifications. 

[0204] <publish-form-control>. . .</publish-form-control> 

[0205] Used with <publish-f orm-option> to create pull-down menus that can be 
used with any editable template tag. The pbname attribute is mandatory. 
[0206] Attributes of <publish- f orm- control > tags: pbname , pblabel , 
pbseparator, size, multiple 

[0207] pbname : The pbname attribute is mandatory. The value of the pbname attribute 
must be unique. 

[0208] pblabel : pblabel attributes help identify the pull-down options on edit- 

forms. The value assigned to the pblabel will appear to the left of the pull-down 
menu. 

[0209] pbseparator : This attribute is only relevant when multiple is specified. If 
the Editor chooses more than one option from the pull-down menu, the values are 
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joined using the pbseparator. The default pbseparator is a comma followed 
by a blank space "). 

[0210] size: The size attribute determines the number of pull-down options that appear 

when the menu is displayed. 
[0211] multiple : When multiple is specified, an Editor may choose more than one 
option from the pull-down menu. 

<publish-form-option>...</publish-form-option> 

Used with <publish-f orm-control> to create pull-down menus that can be 
any editable template tag. 

Attributes of <publish-form-option> tags: pbset_xxx 
pbset_xxx : The pbset_xxx attribute can be used to pass values to any 
editable attribute. It defaults to the content of the tag. 



[0216] <publish-get> 

[0217] The <publ ish-get > tag grabs and inserts template field data anywhere on a 
page. 

[0218] Attributes of publish-get tags: pbsource , pbattr 

[0219] pbsource : The pbsource attribute is mandatory and must be set to the 

pbname of a content tag on the template or on templated pages included in a file- 
index. The <publish-get > tag draws its content from the tag identified in its 
pbsource. 
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[0220] 



pbattr : The pbattr attribute is set to the name of an attribute contained in the 
tag identified by the pbsource. For tags without attributes (<publish- 
title>, <publish-text>), pbattr is ignored. 



[0221] <publish-group> ... </publish-group> 

[0222] The <publ ish-group> tag allows editors to group multiple edit-fields on a 
single edit-form. The pbname attribute is mandatory. 

[0223] Attributes of publish -group tags: pbname , pblabel , pbedi tmarker , 
pbeditmarkerdirection 

[0224] pbname : The pbname attribute is mandatory. However, the value of the pbname 
attribute does not need to be unique. All tags that are enclosed with <publish- 
group> tag that have the same pbname will be edited with the same edit-form. 

[0225] pblabel : pblabel attributes help create user-friendly edit-fields on edit-input 
forms. The value assigned to the pblabel will appear above the edit-fields created 
for the <publish-group> tag. 

[0226] pbedi tmarker : This optional attribute determines whether the orange edit- 
marker will appear at the point where the group tag would display in the Edit- 
Marker mode or not. If pbedi tmarker is omitted, the value will default to yes 
and the edit-marker will appear. If the value of pbeditmarker is set to no, the 
edit-marker will not show up. 

[0227] pbeditmarkerdirection : This attribute control which way the arrow in the 
orange edit-markers points. It can take four possible values: left, right, up or down. 
If the attribute is omitted, the value defaults to right. 
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[0228] <publish-if -cross -post>...</publish- if -cross -post> 
<publish-if -not- cross -post >...</publish- if -not -cross -post > 
[0229] Allows you to display content conditionally depending on whether a page is a cross- 
post destination or not. 

[0230] Attributes of <publish-if -cross-post> and <publish-if -not- 
cross -post > tags: none 
[0231] There are no attributes. 

[0232] <publish-if-empty>. . .</publish-if-empty> 
<publish-if-not-empty> ... </publish-if-not-empty> 

[0233] These tags look at the tag identified by their pbsource attribute (the pbsource 
attribute is mandatory, and must match the pbname value for a content tag elsewhere on the 
template.) If there is no content (whitespace is considered as no content) stored for the named tag 
then everything inside the <publish-if -empty> tag is included. If there is content in the 
named tag then the HTML inside the <publish-if -empty> tag is not included. The 
<publish-if -not-empty> tag is just the opposite. 

[0234] Attributes of <publish-if -empty> and <publish-if -not-empty> tags: 
pbsource , pbattr 

[0235] pbsource : The pbsource attribute is mandatory. Its value must be set to the 
pbname of another content tag on the template. 
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[0236] pbattr : The pbattr attribute identifies the attribute field that the <publish- 
if -empty > or <publ i sh- if -not -empty > tag should look at when 
determining whether a source tag is empty or not. 

[0237] <publish-if-loop-empty> . . . </publish-if-loop-empty> 
<publish-if-loop-not-empty> ... </publish-if-loop-not-empty> 

[0238] Encloses HTML that is included only if the specified loop is or is not empty. 
[0239] Attributes of <publish-if -loop-empty> and <publish-if -loop-not- 
empty> tags: pbsource 

[0240] pbsource : The pbsource must be set to the value of the pbname of a 

<publish-loop> tag. You will almost always want to specify the pbsource 
attribute. However, if you use either the <publish-if - 1 oop - not- empty > or 
the <publ i sh- i f - loop - emp ty > tag inside a loop, the tags will draw their 
source from the immediately enclosing loop by default and will not require a 
pbsource. 

[0241] <publish-img> 

[0242] Maps to the HTML <img> tag. Either the pbname or pbsource attribute is 
mandatory. 

[0243] Attributes of <publish- img> tags: pbname , pbsource , pblabel , 
pblabel_xxx pbeditmarker , pbeditmarkerdirection, pbhide, 
pbcontrol, src, width, height, border, alt, other 
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pbname : The pbname attribute is mandatory if the content of the <publ ish- 
img> tag is editable. The value of the pbname attribute must be a unique name 
within the template. 

pbsource : The value of this attribute must be set to the value of a pbname that 
belongs to another <publ ish - img> tag on the template. It is useful to set the 
pbsource when an image is repeated in several places on a templated page, 
pblabel : pblabel attributes help create user-friendly image edit- fields on 
edit-forms. The value assigned to the pblabel will appear above the edit-fields 
created by the <publish-img> tag. 

pblabel_xxx: The pblabel_xxx attribute allows you to add labels for each 
edit- field generated by an editable attribute. The __xxx is just a placeholder for the 
name of the attribute that you would like to create a label for. Labels generated with 
pblabel_xxx attributes will appear to the right of the edit- fields on the edit-form. 
If the pblabel_xxx attribute is omitted, a default label will be generated based 
on the HTML attribute name. 

pbedit marker : This optional attribute determines whether the orange edit- 
marker will appear beside the edit- field in Edit-Marker mode or not. If 
pbeditmarker is omitted, the value will default to yes and the edit-marker will 
appear. If the value of pbeditmarker is set to no, the edit-marker will not be 
displayed. 

pbedi tmarkerdirect ion : This attribute control which way the arrow in the 
orange edit-markers points. It can take four possible values: left, right, up or down. 
If the attribute is omitted, the value defaults to right. 
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pbhide: This attribute hides the output of an editable template tag. <publish- 
img> tags which have a pbhide attribute set to yes will allow users to edit the 
content of the <publ i sh- img> tag, but that content will not be passed to the 
pages created with that template. The default value of pbhide is no, 
pbcontrol : The pbcontrol attribute specifies that the <publish-img> tag 
should draw its content from a pull-down menu created with a <publish- f orm- 
control> tag. You must have or include a <publish-f orm-control> on 
your template to use this attribute. 

src: the src attribute defines the source URL. Use an asterisk to make the image- 
source editable. Any path information that follows the * will be used as a default 
value. 

alt: the alt attribute defines the alternate text. Use an asterisk to make the alt- 
text editable. Any text that follows the * will be the default value, 
width: the width attribute defines the image width. Use an asterisk to make the 
width editable. Any integer that follows the * will be used as a default width 
value. 

height: the height attribute defines the image height. Use an asterisk to make 
the height editable. Any integer that follows the * will be used as the default 
height value. 

border: the border attribute defines the image border. Use an asterisk to make 
the border editable. If you do not use an asterisk, the border for all images created 
will be the border you have chosen and the user will not be able to change it. 
other: All other HTML attributes can be made editable with an asterisk. 
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[0258] <publish-include> 

[0259] The <publish~include> tag is used to incorporate HTML into a template from 
another file. It allows a common fragment of HTML to be shared by several templates. Any tags 
that are included are treated as part of the including template. The pbf ile attribute is required. 
[0260] Attributes of <publish-include> tags: pbf ile , pbignoredependency 
[0261] pbf ile: The pbf ile attribute is required. The value must consist of the name 

and full path of the included file. The path should start with a 7" which represents 

the top level of the user's account. 
[0262] pbignoredependency: If a pbignoredependency attribute is set, the 

including file will not be dependent on the included file. If the include file is 

changed, the template will not be flagged as modified and your pages will not be 

republished. 

[0263] <publish-index-anchor> 

[0264] The <publ i sh- index- anchor > tag automatically creates an anchor (ie. <a 
name= ..>) with a unique name. It is used to create named anchors for items within indexed 
loops. Used together, the <publish-index-anchor> and <publish- index- link> 
tags automate the creation of links from entries in an index to corresponding entries in a loop. 
The pbname attribute is required. 

[0265] Attributes of <publish- index- anchor > tags: pbname , name , other 
[0266] pbname: The pbname attribute is required. The value must be unique. 
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[0267] name: If a name attribute is supplied it is used as a prefix for the anchor. If no 
name attribute is supplied the anchor(s) will simply be named "1", "2 f \ etc. 

[0268] other : Any other attributes in the <publ i sh- index- anchor > tag are passed 
through unchanged to the <a> tag. 



[0269] <publish-index-file> 

[0270] The <publish- index- f ile> may only appear inside a <publish- file - 
index> tag. It is replaced with the pathname of the file currently being enumerated by the 

u <publish-f ile-index> tag that contains it. 

rj [0271] Attributes of <publish- index- f ile> tags: none 

^3 [0272] There are no attributes. 

L. [0273] <publish-index-link> ... </publish-index-link> 

p [0274] This tag is intended for use inside <publish-f ile-index> or publish- 
Q loop- index tags. It creates a link (ie. <a href= ..>) from an index entry to the thing being 
indexed ~ either a named anchor or an indexed page. 

[0275] Attributes of <publish- index- link> tags: pbsource , href , other 
[0276] pbsource; The pbsource attribute is not mandatory. When it is present, its 
value identifies the <publish-a> or <publish-index-anchor> tag to 
which the <publish- index- link> will link. When used with an index-file, 
the pbsource should not specified, and the tag will default to produce a link for 
each page referenced by the <publ ish- index- f ile> tag. 
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[0277] href: If present, the value of the href attribute is appended to the URL generated 
by the <publish- index- link> tag. This allows you include CGI parameters 
or, in the case of a file-index, an anchor name. 

[0278] other All other attributes of the <publ i sh - index- 1 ink> tag are passed 
unchanged to the HTML<a> tag generated. 

[0279] <publish-loop> . .. </publish-loop> 

[0280] The <publish- loop> tag is used to create repeating sets of items, like tables or 
lists. Everything inside this tag is repeated for each iteration of the loop. Loops may be nested. 
The pbname attribute is mandatory. 

[0281] Attributes of <publ i sh- loop> tags: pbname 

[0282] pbname : The pbname attribute is mandatory. The value of the pbname attribute 

must be a unique name. 
[0283] <publish-loop-count> 

[0284] The <publ i sh- loop- count > tag is replaced with the number of entries in the 
specified loop tag. 

[0285] Attributes of <publish- loop-count> tags: pbsource 
[0286] pbsource : The pbsource attribute must refer to the pbname attribute of a 
<publish- loop> tag at the same level of loop-nesting or in outer loops. If the 
pbsource tag is omitted, the <publish- loop- count > tag will reference the 
immediately enclosing loop. 
[0287] <publish-loop-counter> 
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[0288J The <publ ish- loop-count er> tag is replaced with the number of the current 
iteration of a loop. ie. On the first loop iteration this has the value "1", on the second iteration it 
is "2" and so on. 

[0289] Attributes of <publish- loop- counter > tags: pbsource 
[0290] pbsource : The pbsource tag must be set to the pbname of an enclosing 
<publish-loop> tag. If the pbsource is omitted, the <publish-loop- 
counter> tag will reference the immediately enclosing loop by default. 
[0291] <publish-loop-index> ... </publish-loop-index> 

[0292] The <publi sh- loop- index> creates an index that corresponds to a publish- 
loop. As records are added, removed, or rearranged within the source <publish- loop>, the 
<publish-loop-index> tag automatically revises its index to keep in sync. The 
pbsource attribute is mandatory. 

[0293] Attributes of <publish-loop- index> tags: pbsource , pbsortname , 
pbsortdirection, pbmaxi terns 

[0294] pbsource : The pbsource is mandatory and must be set to the value of the 

pbname of a <publish-loop> tag. All edit-fields within the publish-loop-index 
must refer to edit-fields named in the source <publish- loop>. 

[0295] pbsortname: The pbsortname attribute allows a template designer to sort the 
fields in a publish-loop index alphabetically. It should be assigned the value of the 
pbname of the edit-field that you wish to determine how the loop index is sorted. If 
this attribute is omitted, the order of the loop-index will default to match the order 
of the records in the original source-loop. 
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[0296] pbsortdirection : This attribute controls the direction of an alphabetical sort. 
It may be assigned a value of either ascending or descending. If this attribute is 
omitted, the value will default to ascending. 

[0297] pbmaxi terns : This attribute can be set to an integer that determines the 

maximum number of entries displayed in the loop-index. This allows the loop-index 
to have fewer entries than the source-loop. If the pbmaxi terns attribute is omitted, 
all records in the source-loop will be indexed by the loop-index. 

[0298] <publish-lt> & <publish-gt> 

[0299] The <publish-lt > and <publish-gt> tags are replaced with < and > 
respectively. You can use <publish- It > and <publish-gt > to hide the < and > symbols 
from the web publishing system just as you would use the < and > entities to hide < and > 
from a browser. 

[0300] Attributes of <publish-lt> tags: none 
[0301] There are no attributes. 

[0302] <publish-meta> 

[0303] The <publ ish-meta> tag maps to the HTML <meta> tag. The pbname 
attribute is mandatory. 

[0304] Attributes of <publish-meta> tags: pbname , pblabel , 
pblabel__xxx, pbcontrol, name, content, other 

[0305] pbname : This is a mandatory attribute. The value of the pbname attribute must be 
unique. 
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[0306] pblabel : pblabel attributes help create user- friendly meta edit-fields on edit- 
forms. The value assigned to the pblabel will appear above the edit-fields created 
by the <publish-meta> tag. 

[0307] pblabel_xxx: The pblabel__xxx attribute allows you to add labels for each 
edit-field generated by an editable attribute. These labels can help clarify the 
expected input or offer brief instructions to people entering information in the edit- 
form. The _xxx is just a placeholder for the name of the attribute that you would 
like to create a label for. Labels generated with pblabel_xxx attributes will 
appear to the right of the edit-fields on the edit-form. If the pblabel_xxx 
attribute is omitted, a default label will be generated based on the HTML attribute 
name. 

[0308] pbcontrol : The pbcontrol attribute specifies that the <publish-text> 
tag should draw its content from a pull-down menu created with a <publish- 
f orm- control > tag. You must have or include a <publ i sh- f orm- 
control> on your template to use this attribute. 

[0309] name: The name attribute is the same as its HTML counterpart. The name 

identifies the type of meta tag you are creating (eg: description, keywords, target). 

[0310] content: The content attribute corresponds to its HTML counterpart. The 

value of the content attribute will appear as the value of the content attribute 
of the HTML meta-tag. Any value preceded by a (*) will be editable. 

[0311] other: The value of any other attributes preceded by a (*) will be editable. 

[0312] <publish-rewrite>... </publish-rewrite> 
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[0313] This tag specifies that the web publishing system rewrite relative URLs to be 
absolute. All relative URLs (except for anchor links that reference named anchors on the same 
page) that are nested in a <publish-rewrite> tag will be rewritten when pages are 
previewed, edited and published in your account. While editing, links will be treated as if they 
were external URLs, and pages will open without the Design Manager button bar. 
[0314] Attributes of <publish-rewrite> tags: pbbase 
[0315] pbbase: The pbbase attribute is optional It specifies a base address that is 
prefixed to all relative URL references (except for anchor links that reference 
named anchors on the same page, <a href = " #top " >) nested inside the 
<publish- rewrite > tag. If the pbbase attribute is omitted, the Site Base will 
be used. Example of pbbase: "http://www.mysite.com/press/". 

[0316] <publish-text> ... </publish-text> 

[0317] The <publish- text > tag is used to create edit-fields for nonspecific text. Any 
text and HTML that appears between the open and close <publish- text > tag will be used as 
default content. Either the pbname or pbsource attribute is mandatory. 
[0318] Attributes of <publish- text> tags: pbname , pbsource , pbrows , 
pbcols, pblabel, pbeditmarker , pbeditmarkerdirection, pbhide, 
pbtexteditor, pballowhtml, pbcontrol, wrap 

[0319] pbname : The pbname attribute is mandatory if the content of the <publ i sh- 
text > tag is editable. The value of the pbname attribute must be a unique name. 

[0320] pbsource : The value of this attribute must be set to the value of a pbname that 
belongs to another <publish- text > tag on the template. 
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pbrows : This optional attribute gives the template designer control over the 
appearance of the text edit-field on the edit-form. When the value of pbrows is set 
to 1, the input will be a single line. Any other value will create a corresponding long 
multiple line text edit-field. If the pbrows attribute is not set, it will be assigned a 
default value of 5. 

pbcols : The pbcols attribute works much like the pbrows attribute, only it 
affects the width of the text edit-field instead of the height. The default value of this 
attribute is 60. 

pblabel : pblabel attributes help create user-friendly text edit-fields on edit- 
forms. The value assigned to the pblabel will appear above the edit-form input, 
pbeditmarker : This optional attribute determines whether the orange edit- 
marker will appear beside the edit-field in the Edit-Marker mode or not. If 
pbeditmarker is omitted, the value will default to yes and the edit-marker will 
appear. If the value of pbeditmarker is set to no, the edit-marker will not 
display. 

pbedi tmarkerdirect ion : This attribute control which way the arrow in the 
orange edit-markers points. It can take four possible values: left, right, up or down. 
If the attribute is omitted, the value defaults to right. 

pbhide: This attribute hides the output of an editable template tag. publish- 
text tags which have a pbhide attribute set to yes will allow users to edit the 
content of the publish - text tag, but that content will not be passed to the pages 
created with that template. The default value of pbhide is no. 
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[0327] pbtexteditor : This attribute specifies how text is edited in template edit- 

forms. If the attribute is omitted, the value will default to the account setting. (If a 
value has not been set for the account, a default setting of mapeol is used 
throughout the site.) The pbtexteditor attribute is ignored for single-line text 
edit-fields. The attribute can have one of three values: mapeol raw, or rich. 

[0328] pbal lowhtml : This attribute controls which HTML tags are allowed in the text 
edit-field. If pbal lowhtml is not specified then the default setting (set with the 
option in the Design area) for the account is used. (If a value has not been set for the 
account, a default setting of ask is used throughout the site.) The pbal lowhtml 
attribute can have one of three values: any, basic, or ask. 

[0329] pbcontrol : The pbcontrol attribute specifies that the <publish-text > 
tag should draw its content from a pull-down menu created with a <publ ish- 
f orm-control > tag. You must have or include a <publ ish- form- 
control > on your template to use this attribute. 

[0330] wrap : The wrap attribute is passed through to the HTML <textarea> tag on the 

edit-form for this field. The wrap attribute controls how the <textarea> edit control 
wraps text, and how line breaks are returned to the server when the form is 
submitted. The default value is soft. It can be set to: soft, hard, off. 

[0331] <publish-title> ... </publish-title> 

[0332] The <publish- tit le> tag maps to the HTML <title> tag. The <publish~ 
title> tag is assigned the pbname: Jitle. 

[0333] Attributes of <publish- title> tags: pbcols, pblabel , pbcontrol 
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[0334] pbcol s : The width of the text edit-field created on the edit-form. The default is 
60. 

[0335] pblabel : pblabel attributes help create user-friendly title edit-fields on edit- 
forms. The value assigned to the pblabel will appear above the edit-form input. 

[0336] pbcontrol : The pbcontrol attribute specifies that the <publish-text> 
tag should draw its content from a pull-down menu created with a <publish- 
form- control > tag. You must have or include a <publish-f orm- 
control > on your template to use this attribute. 

[0337] Appendix II 

[0338] This Appendix II includes further discussion of the use of special tags used in one 
embodiment to the invention. It describes more fully how features such as the automatic linking 
of list documents and the index documents are implemented in that embodiment. While the 
embodiment described in this appendix has specific requirements, these requirements do not 
necessary hold over in other embodiments. In other embodiments, additional tags and attributes 
may be used, entirely different sets of tags and attributes may be used, or a scheme different than 
HTML-style tags attributes may be used. The discussion: 

[0339] 1 . Creating Indexes that Update Automatically When New Content is Added 
[0340] The template language gives template designers the power to create templated index 
pages. Templated index pages can save hours of production maintenance time - once an index 
page has been set up in a template, it will automatically update. For example, in the old days, 
with only straight HTML, a site developer had to update a site home page every time a breaking 
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news story was posted. Quite likely that developer also had to modify numerous other site pages 
with links to the new content. With indexes, all of the pages that formerly had to be modified by 
hand can be updated automatically every time a new story is published. Any page that is affected 
by a change, (all the pages which link to the new content page in this example) will be published 
again when the new story is published. 

[0341] There are a number of different ways to create and customize indexes templates. 
This section takes a look at the tags and strategies needed to get going with automatically 
generated indexes. 

[0342] 1.1. Creating an Index That Links to Other Documents with <publish- f ile- 
index> 

[0343] The <publish-f ile-index> tag creates a list of records from content that 
lives on other pages of the site. As files are added or removed the file-index is automatically 
updated to reflect the changes. 

[0344] The file-index may be sorted by various criteria. Sorting is controlled with the 

pbsortname, pbsortf ormat and pbsortdirection attributes. The pbsortname tells 

the web publishing system which field to use when sorting and its value must correspond to the 

pbname of any editable tag on the indexed pages. The pbsortdirection can be set to 

"ascending," "descending" or "random" and determines how files are sorted. The 

pbsortf ormat attribute can be set to either "text" or "number." By default, values are sorted 

alphabetically. 

[0345] File-indexes are best described with an example. Consider an index of press 
releases. One document is an index of press releases with multiple entries. Each entry 
corresponds to a press release in a separate press release file. 
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[0346] The template code that would generate the press release file-index is shown below. 
In the interest of clarity, this example does not show how to create links between the file-index 
and the indexed files. See Using <publish-file-index> in Conjunction with <publish-index-link> 
for more information on adding links. 

[0347] [ 1] <publish- file- index pbsourcef iles=" /pr/pr* .htm" 

pbsort direct ion= 11 descending " > 

[ 2] <publish-text pbsource="_title" >Untitled</publish-text> 
[ 3] <br> , 

[ 4] </publish-f ile-index> 

[0348] The <publish-file-index> tag on line 1 specifies the source files as "/pr/pr* .htm". 
This pattern matches all files in the 7pr" directory that start with "pr" and end with ".htm". 
Because the pbsortdirection attribute has been given the value "descending", the press 
releases will be listed from newest ("pr003.htm") to oldest ("pr001.htm"). Since there is no 
pbsortname specified, the file-index defaults to work with the individual file names. 
[0349] The <publish-text> tag on line 2 refers the Jitle field (for example, the document 
title) of each file. This assumes that the indexed files each have a title set via a <publish-title> 
tag. If you would like to sort this index by the titles of the pages rather than their file names, you 
can use a pbsortname attribute: 

[0350] <publish- file -index pbsourcef iles= " /pr/pr* .htm" 
pbsortdirection= "descending" pbsor t name ="_ti tie" > 

<publish-text pbsource= "_title" >Untitled</publish- text> <br> 
< / pub lish-file-i ndex > 

[0351] The above example will sort the press releases by title in descending alphabetical 
order. 
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[0352] You may set several paths in the pbsourcef iles attribute. This is handy if you 

would like your file index to list files that are stored in several directories. For example, if you 

add paths to 7pr/01/pr*.html" and 7pr/02/pr*.html", the file index can list press releases that 

were published in January and February even though they are stored in different directories by 

month. Multiple paths must be separated by semi-colons: 

[0353] [ 1] <publish- file -index 

pbsourcef iles= 11 /pr/01/pr* . html ; /pr/02 /pr* . html " 

pbsortdirection= "descending" > 

[ 2] <publish-text pbsource="_title" >Untitled</publish-text> 
[ 3] <br> 

[ 4] </publish-f ile-index> 

[0354] You can also use regular expressions in the value of the pbsource f iles 
attribute. Regular expressions provide a simple way of identifying multiple directories without 
having to enumerate each one. For example: 

[0355] [ 1] <publish-f ile-index pbsourcef iles="/pr/ [0- 

9] */pr* .html" pbsortdirection= "random" > 

[ 2] <publish-text pbsource="_title">Untitled</publish-text> 
[ 3] <br> 

[ 4] </publish-f ile-index> 

[0356] The regular expression in the pbsourcef iles value on line [1] identifies the 
same files specified in the previous example: pages in the 7pr/01/" and 7pr/02/" directories that 
have titles that match "pr*.html". The regular expression "[0-9]*" in the pbsourcef iles 
attribute additionally matches directories called "04", "05" or "12" - any directory that contains 
two digits. 
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[0357] In the above example, the pbsortdirect ion on line [1] has been set to 
"random." When "random" is selected, the order of the items in the index will be shuffled every 
time the index page is updated or modified, checked in and approved. The order will also change 
everytime a site is published with "Publish All," regardless of whether the index file has been 
altered. Because the order changes when pages are published, the previewed order of the file 
index in your account may not match the order of the index when published. 
[0358] There may not be any editable tags inside a <publ ish- f ile - index> tag. Only 
references to other tags may appear. In other words, all tags within a <publ ish- f ile- 
index> must use pbsource rather than pbname. 

[0359] Attributes of <publish-f ile-index> tags: pbsourcef iles , 
pbsortname, pbsortdirect ion, pbsortf ormat , pbmaxitems, pbfilter, 
pbf iltername 

[0360] pbsourcef iles : The pbsourcef iles attribute specifies which files should 
be considered when building the file-index. The value of this attribute may include wildcards, 
regular expressions, path variables or several file specifications. 
[0361] For example: 

[0362] <publish- file- index pbsourcef iles= 
n /news/pr* .htm; /oldnews/press? ? .htm" > 

< / publ ish -file- index> 

[0363] The file-index created with the above code will be populated with information from 
all the files that match the pattern in the value of the pbsourcef iles attribute. The file 
patterns follow standard Unix filename matching rules. Note: you may not use Publish-relative 
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URLs in pbsourcef iles attributes. When a page is published, only content pages that are 
currently approved and pages that have been previously approved and published are included in 
the file-index. During page preview from the Design Manager, however, all pages that meet the 
criteria specified by the pbsourcef iles attribute will be displayed regardless of the approval 
status. The pbsourcef iles attribute does not apply to image, binary or template files. You 
may specify multiple file paths in the pbsourcef iles attribute by separating each with a 
semi-colon (for example, 

pbsource f i les= n /2 0 0 0 / 0 1 /pr * . html ;/2000/02 /pr * . html " ) 
[0364] pbsortname: The pbsortname attribute allows a template designer to sort a 
file-index according to the contents of a specific edit-field. pbsortname should be assigned the 
value of the pbname of the edit-field that should determine how the file-list is sorted. If this 
attribute is omitted, the file-index will default to be sorted by filename. You may use up to ten 
pbsortnames (pbsortname, pbsortname l-pbsortname9) to specify multiple sort fields. 
[0365] pbsort direct ion : This attribute controls the direction of a sort. It may be 
assigned a value of ascending, descending or random. If this attribute is omitted, the value will 
default to ascending. You may use up to ten pbsortdirections (pbsortdirection, pbsortdirectionl- 
pbsortdirection9) to specify multiple sort directions. 

[0366] pbsort format : This attribute controls the type of sort performed. It maybe 
assigned a value of either text or number. If this attribute is omitted, the value will default to text. 
You may use up to ten pbsortformats (pbsortformat, pbsortformatl-pbsortformat9) to specify 
multiple sort formats. 

[0367] pbmaxi terns : This attribute can be set to an integer that determines the 
maximum number of entries displayed in the file-index. This allows the file-index to have fewer 
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entries than the actual number of files. If the pbmaxi terns attribute is omitted, all the files that 
match the pattern will be indexed by the loop-index. 

[0368] pb f i 1 1 e r : The pb f i 1 1 e r attribute allows you to filter the content of a file 
index based on the values in a particular field (which may be specified with a pbf i 1 1 ername 
attribute). Filter expressions start with an operator (~ or > for example) that indicates the type of 
comparison. All comparisons are alphabetic (or "{text}" based) - "A" is less than "B" and "100" 
is less than "20" (though not less than "020") and case-sensitive by default. You can change this 
default with the options "{nocase}" and "{number}." 

[0369] You may compare a string (eg: "index" or "news") with the "=", "<" and ">" 
operators or look for a pattern (eg: "news" or any standard regular expression: "abc . *" or 
" A (Monday | Tuesday) ") with a "~" operator. Any of these comparison operators may be 
prefixed with "!" to negate the comparison. 
[0370] Some possible comparisons are: 



Comparison 


Example 


Filtered files 


-pattern 
(or ! -pattern) 


<publish-file-index 
pbsourcefiles="file*.html" 
pbfilter="~index" 
pbfiltername="_title"> 

The web publishing system can 
use any standard (POSIX 1003.2) 
extended regular expressions as a 
pattern. 


All pages identified by the 
pbsourcefiles attribute that have 
"index" anywhere in their title will 
be included in the file index. 
Note: Pattern matching is the 
default - you may omit the "~" 
before the pattern value except 
when the pattern you are matching 
begins with one of the other filter 
operators (<, > or = for example). 


^string 


<publish-file-index 


All pages identified by the 
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(or !=string) 


pbsourcefiles-'fi le* .html" 
pbfilter="=The Best of this 
Week" pbfiltemame="_title"> 


pbsourcefiles attribute that are 
exactly titled "The Best of this 
Week" will be included in the file 
index. The capitalization and 
wording must be exact. Pages titled 
"The best of this week" will not be 
included with this pbfilter. 


>string 
(or !>string) 


<publish- file-index 
pbsourcefiles="file*.html" 
pbfilter="!>Frank" 
pbfiltername="first_name"> 


All pages identified by the 
pbsourcefiles attribute that have a 
"firstjiame" value that is not 
(because the "!" is used) greater 
than "Frank" will be included in the 
file index. ("Fanny", "Fran", "Bob" 
but not "George" or "Frank"). Note: 
if the "!" were not used, all pages 
that contain values greater than 
"Frank" would be included in the 
file index. 



[0371] pbf iltername : This is the name of the field used for filtering. If this is omitted 
then filtering defaults to the pbsortname field. To do filtering, either pbf iltername or 
pbsortname must be present. 

[0372] 2. The Power of Loops: <publish-loop> and Its Kin 
[0373] In addition to the tags that mirror their HTML counterparts, the web publishing 
system has a number of tags that add functionality beyond that of mere HTML. Those familiar 
with a programming language like Perl or JavaScript, know that loops allow a set of commands 
to be repeated as many times as needed. Like their programming command counterparts, loop 
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tags give users the power to add and update sets of information (like lists or tables) as many 
times as needed. 

[0374] The table below can be created and updated with a simple <publ i sh - 1 oop > tag 
on a template. All the template designer needs to do is nest the text edit-field tags for the 
"Name", "Age" and "Birthday" information along with their HTML formatting between an open 
and close <publish-loop> tag. 



Name 


Age 


Birthday 


Joe 


27 


12/08/73 


Mary 


30 


12/08/70 


Sam 


45 


12/08/55 



[0375] When pages created with publ i sh - 1 oops are edited, a special menu edit-marker 
for loops will appear beside each set of information in the publish-loop. Though the menu edit- 
marker looks like a regular edit-marker, when it is rolled-over the menu edit-marker expands to 
offer a menu of editing options. Users can use the menu edit-marker to edit, delete, reorder or 
add to each set of formatted information. 

[0376] Other tags can be combined with basic <publ i sh - 1 oop > tags to create 
numbered loop records or display different content depending on whether or not records have 
been added to a loop. All of the loop features are explored in depth in this section. 
[0377] 2.1. Adding Simple Loops with <publish-loop> 

[0378] The <publish-loop> tag is used to create repeating sets of items such as tables 
or lists. Any tag, including <publ ish- loop> tags themselves, may be nested between open 
and close <publish-loop> tags. Once nested, these tags become grouped. The first time a 
<publish-loop> is edited, a single default record will be displayed. This record has a menu 
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edit-marker instead of an individual edit-marker for each tag nested within the <publish- 
loop>. 

[0379] The menu edit-marker allows an editor to edit this initial record or add a new record 
above or below it. If a new record is added, an edit-form with edit-fields for each tag contained in 
the <publish- loop> will collect all of the information needed for a complete record. 
[0380] Each time a new record is added, the information will be formatted with the HTML 
tags contained in the <publish- loop> tags. 

[0381] The following template code will create an HTML t abl e by repeating the row 

information contained in the <publish- loop> tag each time a new set of information is 

added. In this example, <publish- text> tags are used to collect the "Item" and "Price" 

information for each record. 

[0382] <htmlxbody> 
< table border^" 1" width="200 " > 
<publish-loop pbname= n list " > 
<tr> 

<tdxpublish- text pbname=" Item" >New Item</publish-textx/td> 
<tdxpublish-text pbname= H Price" >$0 . 00</publish-textx/td> 
</tr> 
</publish-loop> 

</table> 

< /body > < /html > 

[0383] The above code will generate an HTML table when pages are checked-out for 
editing. A new record can be added to the table above or below a current record in the table by 
choosing the appropriate add symbol (add above or add below) on the edit menu. 
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[0384] Attributes of <publish- loop> tags: pbname 

[0385] pbname : The pbname attribute is mandatory. The value of the pbname attribute 
must be unique within the template. 
[0386] 2.2. Features Specific to Loops 

[0387] There are several features and behaviors of loops that require a bit more discussion. 
The following sections go into more detail about menu edit-markers and the tags used inside 
<publish~loop> tags. 
[0388] 2.2a. Menu Edit-Markers 

[0389] The edit-fields inside a loop are grouped for editing and a menu edit-marker is 
displayed beside each set of looped data when pages are checked-out for editing. The menu edit- 
marker is displayed either at the first editable field that falls between the open and close 
<publish-loop> tags that does not specify pbeditmaker= "no" or at a <publish- 
edit - marker > tag - whichever comes first. You cannot use the 

pbeditmarkerdirect ion attribute to change the direction of the arrow that appears in a 
menu edit-marker. 

[0390] When the user rolls over the menu edit-marker a popup edit menu is displayed. 
This menu allows you to edit the record, delete it, move the record up, move the record down, 
add a new record above, and add a new record below the one referenced by the edit-marker. 
[0391] If a loop is empty, (for example, if no content has yet been added by an editor) the 
loop is displayed with a dummy loop record and menu edit-marker. The dummy loop makes the 
structure of the page easier to see and provides a place to add more items. 
[0392] The menu edit-marker will appear at the spot where the first tag which does not 
have the pbeditmarker attribute set to no is displayed. For example, if you have three 
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<publish-img> and then a <publish-text> tag in a single <publish-loop>, by 
default, the menu edit-marker will appear beside the first <publish- img> tag. If you would 
like the menu edit-marker to appear beside the text-field, add pbedi tmarker= » no " to each 
of the <publish-img> tags. 

[0393] 2.3. Indexing Loops with <publish~loop-index> 

[0394] The <publish-loop-index> tag creates an index that corresponds to a 
publish-loop. As records are added, removed, or rearranged within the source <publish- 
loop>, the <publish-loop-index> tag automatically revises its index to keep in sync. 
[0395] For example, consider a FAQ document. The body of the FAQ - the names and 
answers to each questions - is generated with a publish-loop. Above the body is a list of 
only the FAQ questions. This list, or index, is generated with a <publ i sh- 1 oop - index> 
tag. As records are changed in the body of the FAQ (in the source <publish-loop>), the 
loop-index at the top is automatically updated (in the <publish-loop-index>). 
[0396] Because the loop-index corresponds to an existing source-loop, the <publ ish- 
loop- index> tag may not contain any editable edit- fields. Another way of saying this is that 
all edit-fields in a <publish- loop- index> tag must have a pbsource rather than a 
pbname and that the value of the pbsource must be a pbname assigned to an edit-field in the 
source-loop. 

[0397] Although this may be confusing at first, the functionality of the <publish- 
loop- index> is clarified by looking at the template code that generates this HTML FAQ list. 
In the interest of clarity, this example does not show how to create links between a source-loop 
and a loop-index. 
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[0398] [ 1] <publish-loop-index pbsource- 'faqs"> 
[ 2] <publish-text pbsource= M question"x/publish-text> 
[ 3] <br> 

[ 4] </publish-loop-index> 
[5] 

[ 6] <publish-loop pbname="faqs"> 
[ 7] <h4> 

[ 8] <publish-text pbname- ? question">Default faq question</publish-text> 

[ 9] </h4> 

[10]<p> 

[11] <publish-text pbname- 'answer">Default faq answer. </publish-text> 
[12] </p> 

[13] </publish-loop> 

[0399] The <publish- loop> tag on line 6 (named faqs by the pbname attribute) is a 
normal publish-loop with two text fields: question and answer. It becomes a source-loop when its 
pbname is assigned to the pbsource attribute of the <publish- loop- index> on line 1. 
The <publish-loop-index> looks to the faqs loop for its source values — it may reference 
either of the edit-fields in the source-loop {question or answer) with non-editable edit- fields 
assigned pbsource attributes. For example, the <publish-text> tag in the <publish- 
loop- index> on line 2 uses its pbsource attribute to specify that its content be drawn from 
the question edit-field in the faqs source-loop. 

[0400] Because the <publ ish- loop- index> takes its values from the source-loop, the 
index it generates is not directly editable and the loop-index will not get an edit-marker. In order 
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to change "How do I use publish" to "How do I use the web publishing system?" an Editor would 
have to change the value in the original source-loop. Whenever the faqs source-loop gets 
updated, the changes will be reflected in the loop-index. Any additions or deletions to the source- 
loop will be reflected in the loop-index as well. Note: if your template source loop has default 
content, that content will not appear in the loop-index until you edit and Save it. 
[0401] Attributes of <publish-loop-index> tags: pbsource , pbsortname , 
pbsortdirection, pbmaxi terns 

[0402] pbsource : The pbsource is mandatory and must be set to the value of the 
pbname of a <publish-loop> tag. All edit-fields within the <publish-loop-index> 
must refer to edit-fields named in the source <publish- loop>. 

[0403] pbsortname: The pbsortname attribute allows a template designer to sort the 
fields in a publish-loop index alphabetically, pbsortname should be assigned the value of the 
pbname of the edit-field that should determine how the loop index is sorted. If this attribute is 
omitted, the order of the loop-index will default to match the order of the records in the original 
source-loop. 

[0404] pbsortdirection : This attribute controls the direction of an alphabetical sort. 
It may be assigned a value of either ascending or descending. If this attribute is omitted, the value 
will default to ascending. 

[0405] pbmaxi terns : This attribute can be set to an integer that determines the 
maximum number of entries displayed in the loop-index. This allows the loop-index to have 
fewer entries than the source-loop. If the pbmaxi terns attribute is omitted, all records in the 
source-loop will be indexed by the loop-index. 
[0406] 2.3a. Sorting Loop-Indexes 
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[0407] Though it is nice that loop-indexes automatically match the order of records in their 
source-loop, it is sometimes desirable to arrange loop-indexes in other ways. For example, a 
source-loop that contains information about company employees may be arranged by department. 
Its loop-index, however, might consists only of employee names and would be far more useful if 
arranged alphabetically according to the first letter of the names. 

[0408] This is type of sorting can be done with the pbsortname attribute, pbsortname 
should be assigned the value of the pbname of the edit-field that should determine how the file- 
list is sorted. The sorting order defaults to ascending (from a to z). However, this order can be 
overruled with the pbsortdirection attribute. If a pbsortdirect ion attribute is set to 
descending, the records in the loop-index will be sorted in reverse alphabetical order. 
[0409] For example: 
[0410] <html><body> 
<publish-loop pbname- ! loopsource rr > 

<publish-text pbname="department M x/publish-text><br> 

<publish-text pbname- 'name"x/publish-textxbr> 

<publish-text pbname="content ?? ></publish-text><br> 
</publish-loop> 

<publish-loop-index pbsource="loopsource" pbsortname="name" pbsortdirection="descending"> 
<publish-text pbsource-'name"x/publish-text> 
</publish-loop-index> 
</bodyx/html> 
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[0411] The above code will produce a loop-index arranged by the values entered in the 
name text-field in reverse alphabetical order, regardless of how the original records are arranged 
in the source-loop. If not pbsortname is specified, the sorting will default to the order in 
which the tags are listed in the <publish-loop>. In the above example, if the pbsortname 
attribute were omitted, the names would be listed according to the reverse alphabetical order of 
the values in the department text-field. 
[0412] 2.3b. Displaying Loop-Indexes 

[0413] Another nice feature of loop-indexes is that the number of records indexed need not 
be the same as the number of records in the source-loop. This is really handy on pages that only 
need to reference a subset of the source information: the most recent three updates, or just the 
names that begin with "A". 

[0414] Though loop-indexes default to display an index record for each source record, the 
pbmaxi terns attribute can be used to limit the number of index records that are created and 
displayed on pages. A pbmaxi terns value of 5 will produce a loop-index that consists of only 
the top five records. 

[0415] The top five records are determined after the loop-index has been sorted » so the 
top five records in this example may be either the first five alphabetical records, the last five, or 
the first five records displayed in the source-loop. 

[0416] 3. Linking for Indexes, Including Loop Indexes 

[0417] 3.1. Using <publish-f ile-index> in Conjunction with <publish- 
index-link> to Create Links 
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[0418] The <publish-index-link> tag is used as a stand alone tag or inside both 
<publish- index- f ile> and <publish- index- loop> tags. The <publish- 
index- 1 ink> tag creates a link (for example, <a href= ..>) from an index record to the thing 
being indexed — either a named anchor or an indexed page. When used in a file- index, the 
<publ ish- index- 1 ink> tag can generate a link to either a standard page, or a page with 
anchor or CGI information. 

[0419] The code below uses < pub 1 i sh - i ndex - 1 i nk > to create links around the titles 
of the files enumerated in a file-index: 

[0420] <publish-f ile-index pbsourcef iles="pr* .htm" > 

<publ ish- index- linkxpubl ish- text pbsource="__title n ></publish- 
textx /publish- index- linkxbr> 
</publish-f ile-index> 

[0421] If there are three pages named "prOOl .htm", ?, pr002.htm f ' and "pr003.htm" then this 
template produces the following result: 

[0422] <a href = n pr001.htm">Title of pr001</axbr> 
<a href ="pr002 , htm" >Title of pr002</axbr> 
<a href = "pr003 .htm" >Title of pr003</axbr> 

[0423] The <publ i sh- index- 1 ink> tag generates an <a> tag that links to each 
enumerated file with a document-relative URL. The <publish-text> tag in the above 
example, inserts the title of each page into the index. If you want the URL to include an anchor 
or any CGI parameters, those must be set in the href attribute of the <publ ish- index- 
link> tag, as follows: 
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[0424] <publish- index- link href ="#intro" xpublish-text 
pbsource= ,r _title n ></publish-textx/publish- index- link> 
[0425] The HTML the above template code will produce for each index record will look 
something like this: 

[0426] <a href = n pr001 .htm#item" >Title of pr001</a> 
[0427] Other attributes that appear in the <publish-index-link> tag are passed 
through to the <a> tag unchanged. For example, you could include a target = "_blank" 
attribute to open the page in a new window. 

[0428] The <publish-index-link> tag may also be used inside <publish~loop- 
index> tags to create a document with an index of anchored links. 

[0429] You may also use the <publ i sh- index- 1 ink> tag to create a link to a single 
<publish-a> tag anywhere on a page (without either a loop- or a file -index tag). For 
example: 

[0430] <publish-a pbname= ,! anchor" name= n * ,f ></publish- 
a> Introduction 

<publish- index- link pbsource= n anchor" >Back</publ ish- index- link> 
[0431] In this example, the name attribute of the <publish-a> tag is editable. Because 
the anchor name value will change according to the whims of an editor, it is impossible for a 
template Designer to use a second <publish-a> tag to reference it. 
[0432] However, the <publish- index-link> tag creates an anchor link that will 
match whatever value is entered in the edit-form. If an Editor uses an edit-form to enter "intro" as 
the name of the anchor, the above code will produce the following HTML: 
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[0433] <a name= n intro"x/a>Int reduction 
<a href ="#intro" >Back</a> 

[0434] Attributes of <publish- index- link> tags: pbsource, href, (other) 
[0435] pbsource: The pbsource attribute is not mandatory. When it is present, its 
value identifies the <publish-a> or <publish~ index-anchor > tag to which the 
<publish-index-link> will link. When used with an index-file, the pbsource should 
not specified, and the tag will default to produce a link for each page referenced by the 
publish- index- file tag. 

[0436] href: If present, the value of the href attribute is appended to the URL generated 
by the <publish- index-link> tag. This allows you include CGI parameters or, in the case 
of a file-index, an anchor name. 

[0437] (other) All other attributes of the <publish- index- link> tag are passed 
unchanged to the HTML<a> tag generated. 

[0438] 3.2. Using <publish- f ile-index> in Conjunction with <publish- 
index- f ile> to Show which File is being Enumerated 

[0439] The <publish- index- f ile> tag is only used inside <publish-f ile- 
index> tags. The <publish- index- file> tag is replaced with the complete path of the 
file currently being enumerated by a <publ ish-file - index> tag. For example: 
[0440] <publish-f ile-index pbsourcef iles= M /pr/pr* ,htm n > 
<publish- index- file> (<publish-text pbsource= n _title"x/publish- 
text>) <br> 

</publish-f ile-index> 
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[0441] If there are three pages in the 7pr/" directory that begin with "pr", the paths of those 

files will replace the <publish- index- f ile> tag. As in the previous example, the 

<publ i sh- 1 ext > tag is replaced by the titles of the pages that match the criteria (provided a 

page title is defined). The output might look something like this: 

[0442] /pr/pr001 .htm (Title of First Press Release) 

/pr/pr0 02 .htm (Title of Second Press Release) 

/pr/pr003 .htm (Title of Third Press Release) 

[0443] The <publish- index- file> tag is useful for debugging or experimenting 
with file indexes as it clearly shows which files are being enumerated. 

[0444] You can create links around the file path information generated by the <publ i sh - 

index- file> tags by nesting them in a <publish- index- link> tag: 

[0445] <publish- file- index pbsourcef iles= " / pr/ pr* . htm" > 

<publ i sh- index- 1 ink> <publ i sh- index- f i 1 e > < /publ i sh- index- 1 ink> 

<br> 

< / pub lish-file-i ndex> 

[0446] The above template code would create the following output: 

[0447] <a href ="/pr/pr001. htm" >/pr/pr001.html</a> 
<a href ="/pr/pr 0 02 . htm" >/pr/pr002 .html</a> 
<a href = n /pr*/pr002 .htm" >/pr/pr003 .html</a> 
[0448] The <publish- index- f ile> tag has no attributes. 
[0449] 33. Creating an Index of Anchored Links 

[0450] Indexes of anchored links are created much like file-indexes are. The web 
publishing system has a special tag that is used entirely for this purpose: <publish- index- 
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anchor>. The following sections go into more detail about designing templates that can be used 

for FAQs and other instances when an index of anchored links is necessary. 

[0451] 3.3a. Creating Anchors with <publish- index- anchor> and <publish- 

loop> 

[0452] The <publish-index-anchor> tag will automatically create an anchor (ie. <a 
name=. ..>) and generate a unique value for each anchor name for all records enumerated by a 
publish-loop. When used witha <publish-index-link> & <publish-loop- 
index> tag (a combo that will generate an index of anchor links, eg: <a 
name="anchorl»xa name= "anchor2 " > , etc), <publish- index- anchor> tags 
can be used to automate the creation of anchored links from an index to corresponding entries. 
[0453] The below template code is used to generate a list of HTML anchors: 
[0454] <publish-loop pbname="loop" > 
<publish- index- anchor pbname= "anchor" name="item"> 
<publish-text pbname= "loopcontent " >Def ault Anchor Text</publish- 
text > 

< /publ i sh - 1 oop > 

[0455] In this example, the <publish-index-anchor> tag automatically generates a 
unique value for the anchor name by appending an integer to the value of its name attribute 
{item.) The generated anchors will look like this: iteml, item2, item3, etc. Each record in the 
publish-loop will have a unique anchor that can then be referenced from elsewhere (typically a 
<publish-loop-index>. 

[0456] Attributes of <publish-index-anchor> tags: pbname, name, other 
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[0457] pbname: The pbname attribute is required. The value must be unique within the 
template. 

[0458] name: If a name attribute is supplied it is used as a prefix for the anchor. If no 
name attribute is supplied the anchor(s) will simply be named "1", "2", etc. 
[0459] ( other ) Any other attributes in the <publ i sh- index- anchor > tag are 
passed through unchanged to the <a> tag. 

[0460] 3.3b. Using <publish- index- link> and <publish-loop-index> to 

Link to Anchors 

[0461] When used inside a <publish-loop-index>, the <publish- index- 
link> tag creates links to named anchors. Each record that the publish- loop- index 
generates will receive an anchored link that will click through to the original record in the source- 
loop. 

[0462] The pbsource attribute of the <publish- index- link> tag should be set to 
the pbname of the anchor tag: either a publish-a tag or at publish-index-anchor tag. 
[0463] For example, the below <publish- loop> tag contains a <publish- index- 
anchor tag (pbname=<me/jor) that is used to generate HTML anchors each time an Editor 
adds a record with the menu edit-marker: 
[0464] <publish-loop pbname=" loop" > 
<publish- index-anchor pbname =" anchor" name=" item" > 
<publish-text pbname= " loopcontent " >Def ault Anchor Text</publish- 
text > 

</publish-loop> 
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[0465] The following template code uses <publish-index-link> (inside a 
<publish-loop-index> tag) to create an index of anchored links that will link to each of 
the HTML anchors created: 

[0466] <publish-loop-index pbsource= H loop M > 
<publ i sh- index- 1 ink pbsource= 11 anchor " > 
<publ ish-text pbsource= " loopcontent " >< /publish- text > 
< /publish- index- linkxbr> 

< / publ i sh- 1 oop - index> 

[0467] The pbsource of the <publish- index- link> tag is set to the value of the 

pbname of the <publish- index- anchor > tag (ie anchor). The pbsource of the 

< pub 1 i sh - loop - index > tag must be set to the pbname of the <publish-loop> it 

references as well. This code will generate anchor links that look like: 

[0468] <a href =#iteml>Anchored Title Entered in original 
loop . </a> 

[0469] If you prefer to input anchor names yourself, you can use a <publ i sh- a> tag 
instead of the <publish- index- anchor > tag in the original publish- loop. The below 
<publish- loop> tag contains a <publish-a> tag (pbname=anchor) that has an editable 
attribute name. Each time an Editor adds a record with the menu edit-marker, he or she will be 
prompted to enter a new anchor name: 

[0470] <publish-loop pbname="loop n > 

<publish-a pbname= 11 anchor" name="*item M > 
<publish-text pbname="loopcontent n >Default Anchor 

Text < /publ i sh- 1 ext > 
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</publish-axbr> 
</publish-loop> 

[0471] The default value item will be replaced with whatever name value is entered in the 
edit-form for the <publish-a> tag. In order for this example to work properly, the Editor must 
make sure that each named anchor is unique. The web publishing system does not ensure that 
anchors are unique if they are input and edited manually. The possibility of redundant anchors is 
eliminated when the web publishing system is used to automatically generate anchors with 
<publish-index-anchor> tags. 

[0472] The href attribute of the <publ ish- index- 1 ink> tag may be used to pass 
CGI parameters to the link it generates. For example: 

[0473] [1] <publish-loop-index pbsource= n myloop n > 

[2] <publ ish- index- link pbsource= 11 anchor" href =" ?arg=l"> 
[3] <publish-text pbsource="loopheader" x/publish-text> 
[4 ] < / publ ish- index- 1 inkxbr > 
[5] </publish-loop-index> <brxbr> 
[6] <publ ish- loop pbname="myloop" > 

[7] <publ ish- index- anchor pbname=" anchor" name=" item" > 

[8] <bxpublish-text pblabel = "Enter a Header" 
pbname="loopheader" >Def ault Header< /publ ish- text ></bxbr> 

[9] <publish-text pblabel= "Enter Content" 
pbname = 11 1 oopcont ent " >De f aul t Cont ent < / publ i sh - 1 ext > 

[10] <brxbr> 

[11] < /publ ish- loop> 
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[0474] The <publish-loop- index> that begins on line [1] will generate an index 
based on the original publish-loop ("myloop", beginning on line [6]). The <publish- index - 
link> tag on line [2] generates anchor links based on the anchors named by the <publish- 
index- anchor > tag in the original source loop (line [7]). In addition, the CGI parameter 
named in the href attribute ("?arg=l") of the <publish- index- link> tag [2] is appended 
to the anchor link. The generated page might look something like this: 
[0475] First Anchored Header 
Second Anchored Header 
Third Anchored Header 

First Anchored Header 
Content... 

Second Anchored Header 
Content... 

Third Anchored Header 
Content... 

[0476] The HTML of an individual anchor link would look like this: 
[0477] <a href- M iteml?arg=l#intro n >First Header</a> 
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